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"
}
]
}
Carpetas y etiquetas
Gestión de etiquetas
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"
}
]
}
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://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
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.
Este endpoint en sí es de solo lectura — las etiquetas se siguen creando 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), para el directorio general de etiquetas que aquí se lista. Sí existe una superficie independiente de creación/eliminación, pero limitada específicamente a etiquetas personalizadas: consulta Listar/crear etiquetas personalizadas y Desvincular una etiqueta de un usuario compartido.
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.
- Listar/crear etiquetas personalizadas — las etiquetas personalizadas propias de la cuenta, un subconjunto de lo que devuelve este endpoint.
- Listar etiquetas visibles para tu rol de usuario compartido — el equivalente de esta lista limitado a usuarios compartidos.
- Listar/desvincular etiquetas adjuntadas por un usuario compartido — audita o limpia el etiquetado 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: 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.
Respuesta
200
List of tags
¿Esta página le ayudó?