Skip to main content
La API de gestión es la interfaz programática para todo lo que puedes hacer en el panel de Scanova: crear y actualizar códigos QR, gestionar carpetas y etiquetas, leer leads y envíos de formularios, obtener analíticas y gestionar usuarios compartidos y roles. Es un host independiente del resto de la superficie de la API de Scanova, con su propio esquema de autenticación.
Esta página cubre la arquitectura que se aplica a todos los endpoints de la API de gestión. Para ver la lista completa de endpoints, consulta las páginas enlazadas al final de esta página.

​
Primeros pasos

1

Crea una clave de la API de gestión

Con la sesión iniciada en el panel de Scanova, crea una clave mediante Crear y gestionar claves de API. Elige un environment — sandbox, live, zapier o mcp — al crearla; esta elección es permanente para esa clave y determina qué cuota del plan se verifica en cada solicitud que realice la clave (ver más abajo).
2

Guarda el valor sin procesar de la clave

El valor de la clave devuelto por la llamada de creación es la única vez que lo verás completo — guárdalo de forma segura. No existe un endpoint de “revelar” posteriormente.
3

Llama a los endpoints de datos

Envía la clave como el valor sin procesar del encabezado Authorization contra api.scanova.io, por ejemplo GET /qr/ para listar tus códigos QR.

​
Cuota del plan

Cada solicitud a un endpoint de datos verifica una cuota del plan asociada al environment de la clave:
Si una solicitud al host de datos devuelve 401 con el mensaje “Your plan does not have management API quota” (o los equivalentes específicos de Zapier/MCP), tu plan no otorga esa cuota. Actualmente, el plan Pro canónico no incluye acceso a la API de gestión — solo lo incluyen los planes Free Trial, Enterprise e Internal. Contacta con support@scanova.io si crees que tu cuenta debería tenerlo.
sandbox es únicamente un concepto de etiquetado y cuota — no es un entorno de prueba aislado. Una clave creada con environment: sandbox lee y escribe los mismos códigos QR, carpetas y leads reales que una clave live. No dependas de ella para datos de prueba desechables.
Una clave zapier/mcp además solo se autentica cuando el encabezado User-Agent del cliente que realiza la llamada coincide con su entorno — una clave zapier rechaza las solicitudes a menos que se envíe User-Agent: zapier, y lo mismo ocurre con mcp. Esto se aplica de forma independiente a la verificación de cuota anterior.

​
Qué contiene esta sección

Listar códigos QR

GET /qr/ — el endpoint de datos principal con el que empiezan la mayoría de las integraciones.

Crear un código QR

POST /qr/ — el endpoint de datos principal con el que empiezan la mayoría de las integraciones.
Consulta la barra lateral para ver la lista completa, incluyendo cómo obtener/actualizar/eliminar un único código QR, descargar imágenes de códigos QR y explorar la papelera.

​
Relacionado