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"
}
]
}
API de gestion — Dossiers et tags
Gestion des tags
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"
}
]
}
Les tags sont les étiquettes rattachées aux QR codes pour le filtrage et le reporting — les mêmes tags affichés sous forme de puces dans toute la liste QR Codes du tableau de bord. Cet endpoint renvoie les tags visibles par le compte authentifié, en lecture seule.
Les résultats sont paginés (taille de page 10 par défaut, jusqu’à 100 via
Nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization. Voir la vue d’ensemble de la Management API.Lister les tags
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
Correspondance de préfixe insensible à la casse — renvoie les tags dont le nom commence par cette valeur.
integer
Numéro de page à récupérer.
integer
défaut:"10"
Nombre de tags par page. Maximum 100.
Champs de réponse
integer
ID du tag.
string
Nom du tag, toujours renvoyé en minuscules quelle que soit la façon dont il a été saisi à l’origine.
Cette liste se limite aux tags réellement rattachés à (ou pouvant être assignés aux) QR codes propres du compte — ce n’est pas un annuaire de tags global. Si le compte a des permissions d’utilisateurs partagés basées sur les tags activées, l’ensemble renvoyé peut en outre dépendre des tags auxquels le compte authentifié est limité.
Il n’existe aucun endpoint de création/suppression correspondant sur la Management API — les tags sont créés implicitement lorsqu’ils sont rattachés à un QR code (via le tableau de bord, les endpoints de création/mise à jour de QR codes, ou les opérations groupées), et non via un appel dédié de gestion des tags.
Voir aussi
- Gestion des dossiers — l’autre mécanisme d’organisation des QR codes, utilisé en complément (ou à la place) des tags.
- Lister / créer des QR codes — filtrez les QR codes par nom de tag via
?tags=. - Gestion des utilisateurs partagés — où un ID de tag de cette liste est utilisé pour limiter la visibilité d’un coéquipier.
- Rôles et permissions — comment fonctionne la limitation des permissions basée sur les tags côté tableau de bord.
Autorisations
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.
Réponse
200
List of tags
Cette page vous a-t-elle été utile ?
⌘I