curl --request GET \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
API de gestión — Carpetas y etiquetas
Listar carpetas
GET /folder/
GET
/
folder
/
curl --request GET \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
Las carpetas agrupan códigos QR para su organización — las mismas carpetas que se muestran en la barra lateral Códigos QR > Carpetas del panel. Usa este endpoint para listar las carpetas de una cuenta o crear una nueva desde tus propios sistemas.
Los resultados están paginados (tamaño de página 10 por defecto, hasta 100 mediante
Ambas operaciones requieren 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 para conocer los detalles de autenticación.curl --request GET \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
page_size) y ordenados con los más recientes primero.
integer
Número de página a recuperar.
integer
predeterminado:"10"
Número de carpetas por página. Máximo 100.
string
Filtra a
qr (carpetas de códigos QR estándar) o page (carpetas específicas de páginas del generador de páginas).string
Coincidencia de subcadena sin distinción de mayúsculas y minúsculas con el nombre de la carpeta.
Campos de la respuesta
integer
ID de carpeta — pasa este valor como el valor
folder al filtrar analíticas de QR por carpeta, o al mover códigos QR a la carpeta desde el panel.string
Nombre de la carpeta. Único por cuenta y
folder_type.string | null
Color hexadecimal (p. ej.
#4F6BF4) mostrado junto a la carpeta en la barra lateral, o null si no está definido.integer | null
ID de usuario de quien creó la carpeta —
null si ese usuario ya ha sido eliminado de la cuenta.string
qr o page.integer
Número de códigos QR asignados actualmente a esta carpeta.
string
Marca de tiempo de creación en formato ISO 8601.
string
Marca de tiempo ISO 8601 de la última actualización.
Relacionado
- Crear una carpeta — la otra operación de este mismo endpoint.
- Gestión de etiquetas — el otro mecanismo de organización de QR, usado junto con (o en lugar de) las carpetas.
- Listar / crear códigos QR — filtra códigos QR por un ID de carpeta devuelto aquí mediante
?folder=. - Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este endpoint.
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 folders
¿Esta página le ayudó?
⌘I