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 gestión — Carpetas y etiquetas
Gestión de etiquetas
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"
}
]
}
Las etiquetas son las marcas que se adjuntan a los códigos QR para su filtrado y generación de informes — las mismas etiquetas que se muestran como chips en toda la lista de Códigos QR del panel. Este endpoint devuelve las etiquetas visibles para la cuenta autenticada, solo lectura.
Los resultados están paginados (tamaño de página 10 por defecto, hasta 100 mediante
Requiere una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization. Consulta el resumen de la API de gestión.Listar etiquetas
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
Coincidencia de prefijo sin distinción de mayúsculas y minúsculas — devuelve etiquetas cuyo nombre comienza con este valor.
integer
Número de página a recuperar.
integer
predeterminado:"10"
Número de etiquetas por página. Máximo 100.
Campos de la respuesta
integer
ID de la etiqueta.
string
Nombre de la etiqueta, siempre devuelto en minúsculas independientemente de cómo se introdujo originalmente.
Esta lista se limita a las etiquetas realmente adjuntas a (o asignables a) los propios códigos QR de la cuenta — no es un directorio global de etiquetas. Si la cuenta tiene habilitados permisos de usuario compartido basados en etiquetas, el conjunto devuelto puede además depender de a qué etiquetas está limitada la cuenta autenticada.
No existe un endpoint correspondiente de creación/eliminación en la API de gestión — las etiquetas se crean de forma implícita al adjuntarlas a un código QR (mediante el panel, los endpoints de creación/actualización de QR o las operaciones masivas), no mediante una llamada independiente de gestión de etiquetas.
Relacionado
- Gestión de carpetas — el otro mecanismo de organización de QR, usado junto con (o en lugar de) las etiquetas.
- Listar / crear códigos QR — filtra códigos QR por nombre de etiqueta mediante
?tags=. - Gestión de usuarios compartidos — dónde se usa un ID de etiqueta de esta lista para limitar la visibilidad de un compañero de equipo.
- Roles y permisos — cómo funciona el alcance de permisos basado en etiquetas desde el lado del panel.
Autorizaciones
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.
Respuesta
200
List of tags
¿Esta página le ayudó?
⌘I