curl --request GET \
--url 'https://api.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
Dossiers et tags
Gestion des tags
GET /tag/list/
GET
/
tag
/
list
/
curl --request GET \
--url 'https://api.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://api.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é.
Cet endpoint est lui-même en lecture seule — les tags continuent d’être 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), pour l’annuaire général de tags listé ici. Il existe une surface dédiée de création/suppression, mais limitée spécifiquement aux tags personnalisés : voir Lister/créer des tags personnalisés et Détacher un tag d’un utilisateur partagé.
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.
- Lister/créer des tags personnalisés — les tags personnalisés propres au compte, un sous-ensemble de ce que renvoie cet endpoint.
- Lister les tags visibles pour votre rôle d’utilisateur partagé — l’équivalent de cette liste limité aux utilisateurs partagés.
- Lister/détacher les tags rattachés par un utilisateur partagé — auditer ou nettoyer le marquage 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: YOUR_API_KEY. 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. api.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 ?