curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
Management-API — Ordner & Tags
Tag-Verwaltung
GET /tag/list/
GET
/
tag
/
list
/
curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
Tags sind die an QR-Codes angehefteten Labels zur Filterung und Berichterstattung — dieselben Tags, die als Chips überall in der QR-Codes-Liste des Dashboards angezeigt werden. Dieser Endpunkt gibt die für das authentifizierte Konto sichtbaren Tags zurück, rein lesend.
Ergebnisse werden paginiert (standardmäßig Seitengröße 10, bis zu 100 über
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert. Siehe die Management-API-Übersicht.Tags auflisten
curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
page_size).
string
Groß-/Kleinschreibung ignorierender Präfix-Abgleich — gibt Tags zurück, deren Name mit diesem Wert beginnt.
integer
Abzurufende Seitenzahl.
integer
Standard:"10"
Anzahl der Tags pro Seite. Maximal 100.
Antwortfelder
integer
Tag-ID.
string
Tag-Name, wird unabhängig von der ursprünglichen Eingabe immer in Kleinbuchstaben zurückgegeben.
Diese Liste beschränkt sich auf Tags, die tatsächlich an die eigenen QR-Codes des Kontos angehängt sind (oder ihnen zugewiesen werden können) — sie ist kein globales Tag-Verzeichnis. Wenn für das Konto tag-basierte Berechtigungen für geteilte Benutzer aktiviert sind, kann die zurückgegebene Menge zusätzlich davon abhängen, auf welche Tags das authentifizierte Konto beschränkt ist.
Es gibt keinen entsprechenden Erstellungs-/Löschungs-Endpunkt in der Management API — Tags werden implizit erstellt, wenn sie an einen QR-Code angehängt werden (über das Dashboard, die QR-Erstellungs-/Aktualisierungs-Endpunkte oder Bulk-Operationen), nicht über einen eigenständigen Tag-Verwaltungsaufruf.
Verwandte Themen
- Ordnerverwaltung — der andere QR-Organisationsmechanismus, verwendet neben (oder anstelle von) Tags.
- QR-Codes auflisten / erstellen — filtern Sie QR-Codes nach Tag-Namen über
?tags=. - Verwaltung geteilter Benutzer — wo eine Tag-ID aus dieser Liste verwendet wird, um die Sichtbarkeit eines Teammitglieds einzuschränken.
- Rollen & Berechtigungen — wie die tag-basierte Berechtigungseinschränkung von der Dashboard-Seite aus funktioniert.
Autorisierungen
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Antwort
200
List of tags
War diese Seite hilfreich?
⌘I