API REST para desarrolladores
Acceso a la API: conviértete en un generador de códigos QR
Una API REST para códigos QR dinámicos: crea cualquier tipo, cambia adónde apuntan después de imprimirlos, recibe cada escaneo en un webhook y lleva la analítica a tus propias herramientas. Una sola API key, JSON de ida y vuelta.
Acceso a la API en el plan Enterprise•Documentación en inglés
curl -X POST 'https://api.v2.qrcodekit.com/api/qrs' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"title": "Spring catalogue",
"input": { "url": "https://example.com/catalogue" }
}'Respuesta JSON
{
"uuid": "b7e9c2a4-1234-5678-9abc-def012345678",
"title": "Spring catalogue",
"pathName": "lV58V1",
"state": 0,
"typology": "/api/qr-typologies/0598466c-…"
}- REST + JSON-LD
- API key en una cabecera
- Creación masiva desde CSV
- Webhooks firmados
- Zapier, Make, n8n
- MCP para asistentes de IA
¿Qué es la API de QRCodeKIT?
La API de QRCodeKIT es una API REST con la que tu propio software hace lo mismo que el panel: crear códigos QR dinámicos de cualquier tipo, cambiar su destino, pausarlos o borrarlos, descargarlos y consultar sus escaneos. Las peticiones llevan una API key en la cabecera X-Api-Key y las respuestas son JSON-LD. Los escaneos y los formularios enviados también pueden llegar a tus sistemas en tiempo real mediante webhooks firmados. El acceso a la API está incluido en el plan Enterprise.
Inicio rápido
Tu primer código QR en tres llamadas
Sirve cualquier lenguaje que pueda enviar una petición HTTP.
Crea una API key
En el panel, en Settings → API Keys. Cada clave pertenece a un espacio de trabajo, así que es la única cabecera que necesitas.
X-Api-Key: YOUR_API_KEYElige el tipo de QR
Lista los tipos y copia el @id del que necesitas: Website, PDF, vCard, Menu…
GET /api/qr-typologiesCrea el código QR
Envía el tipo, el destino y un título. Guarda el uuid de la respuesta: lo usarás para cambiar el código más adelante.
POST /api/qrs
Inicio rápido en la documentación →en inglés
Endpoints
Todo lo que hace el panel, por HTTP
Los endpoints principales. La referencia completa se genera a partir de la descripción OpenAPI de la propia API, así que siempre coincide con el servicio en marcha.
Referencia completa de endpoints →en inglés- POST
/api/qrsCrea un código QR de cualquier tipo→ - GET
/api/qrsLista los códigos QR de tu espacio de trabajo, 30 por página→ - GET
/api/qrs/{uuid}Consulta un código QR→ - PATCH
/api/qrs/{uuid}Cambia su destino, su título o su estado→ - DELETE
/api/qrs/{uuid}Lo borra para siempre; también puedes pausarlo→ - GET
/api/qr-download/{uuid}Descarga la imagen del código QR→ - POST
/api/qrs/bulk-createCrea miles desde un CSV, como tarea en segundo plano→ - POST
/api/analytics/queryConsulta visitas por fecha, país, ciudad o dispositivo→
Qué puedes construir
Una integración para todos los códigos que imprimes
Cambia el destino, no la impresión
Un código QR dinámico apunta a un enlace corto que controlas tú. Envía un PATCH solo con los campos que cambian y todas las copias impresas lo siguen. Para desactivar un código sin perderlo, páusalo en lugar de borrarlo.
Gestionar códigos QR →PATCH /api/qrs/{uuid}
Content-Type: application/merge-patch+json
{
"input": {
"url": "https://example.com/summer"
}
}Miles de códigos desde un CSV
Sube un CSV de códigos QR de sitio web, uno por fila con su nombre, su descripción y su URL, lanza una tarea masiva y consulta su estado hasta que termine, directamente en un proyecto si quieres. Las actualizaciones, los borrados y las descargas también funcionan en bloque.
Creación masiva de QR →/api/assets/uploadcatalogue.csv/api/qrs/bulk-createjob/api/jobs/{uuid}Tu marca en cada código
Cada código QR admite un diseño guardado, un logo y parámetros de diseño, así que los códigos que crean tus sistemas se ven como los que tu equipo diseña en el panel.
Ver los campos →
Los escaneos, como datos
Consulta visitas totales y únicas de cualquier periodo, agrupadas por hora, día o semana y desglosadas por país, ciudad o dispositivo. Las fechas llegan en UTC, listas para tus cuadros de mando o tu almacén de datos.
Consultas de analítica →POST /api/analytics/query
{
"date_range": {
"start": "2026-10-01 00:00:00",
"end": "2026-10-31 23:59:59",
"interval": "1d"
},
"metrics": ["visits:total", "visits:unique"],
"dimensions": ["geoip.country_name"]
}Webhooks
Cada escaneo, en tus sistemas en segundos
En el editor del QR, dale a un código una URL de webhook y elige sus eventos: cada escaneo, o cada formulario enviado con sus respuestas. QRCodeKIT envía un POST firmado a tu endpoint, o a Zapier, Make o n8n.
- Dos eventos:
qr.scannedyform.submitted - Firma HMAC-SHA256 en
X-QRK-Signature, y un id de entrega para evitar duplicados - Reintentos automáticos con espera creciente si tu endpoint está caído o lento
- App de Zapier con los disparadores New Scan, New Lead y New Payment, sin URL
POST https://your-app.example/hooks/qrcodekit
X-QRK-Event: qr.scanned
X-QRK-Delivery: b7f3…
X-QRK-Signature: t=…,v1=…
{
"event": "qr.scanned",
"scanned_at": "2026-07-07T10:00:00+00:00",
"first_scan": true,
"qr": { "uuid": "…", "title": "My QR" },
"project": { "uuid": "…", "name": "Campaign" }
}Asistentes de IA
O deja que un asistente de IA haga las llamadas
QRCodeKIT también tiene un servidor MCP, para que Claude, ChatGPT y otros asistentes de IA creen, listen y actualicen tus códigos QR dinámicos desde una conversación. Se conectan con OAuth: no hay ninguna API key que pegar.
Claude
Añade el conector de QRCodeKIT en Claude, en Claude Code o en la app de escritorio.
en inglésChatGPT
Usa la app de QRCodeKIT en ChatGPT: te pide confirmación antes de crear o cambiar un código.
en inglésCursor, VS Code, Windsurf…
Cualquier cliente MCP por Streamable HTTP: mcp.v2.qrcodekit.com/mcp
en inglés
Preguntas frecuentes sobre la API
Lo que preguntan los equipos técnicos antes de integrarla.
¿Qué plan incluye la API de QRCodeKIT?
El acceso a la API forma parte del plan Enterprise, junto con los dominios propios y el inicio de sesión SSO. Compara los planes o reserva una demo y lo configuramos contigo.
¿Cómo me autentico?
Envía tu API key en la cabecera X-Api-Key. Cada clave está vinculada a un espacio de trabajo, así que no necesitas ninguna otra cabecera. Las claves se crean y se revocan en Settings → API Keys. Para aplicaciones en las que tus usuarios inician sesión, la API también acepta tokens JWT en Authorization: Bearer, junto con la cabecera X-Account-Id.
¿Puedo cambiar adónde apunta un código QR después de imprimirlo?
Sí. Un código QR dinámico apunta a un enlace corto, así que un PATCH /api/qrs/{uuid} con la nueva URL actualiza todas las copias impresas. Envía solo los campos que cambian, con el tipo de contenido application/merge-patch+json.
¿Puedo crear códigos QR de forma masiva?
Sí. Sube un CSV de códigos QR de sitio web (nombre, descripción y URL por fila), lanza una tarea con POST /api/qrs/bulk-create y consulta /api/jobs/{uuid} hasta que su estado sea OK. También hay endpoints para actualizar, borrar y descargar códigos en bloque.
¿Puedo recibir los escaneos en tiempo real?
Sí, con webhooks. Un código QR puede enviar los eventos qr.scanned y form.submitted a tu endpoint HTTPS, a Zapier, a Make o a n8n, normalmente en cuestión de segundos. Cada entrega va firmada con HMAC-SHA256 y se reintenta automáticamente si tu endpoint falla.
¿Qué formato usa la API?
JSON de ida y vuelta. Las respuestas siguen JSON-LD con Hydra: cada recurso tiene un @id y las colecciones llegan en páginas de 30 elementos, con enlaces hydra:view a las siguientes.
¿Qué errores puede devolver?
401 si la clave falta o está revocada, 402 si has llegado al límite de códigos QR de tu plan, 403 si el código pertenece a otro espacio de trabajo, 404 si el uuid no existe, 422 si hay un error de validación, con un array violations que nombra cada campo no válido, y 429 si superas el límite de peticiones.
¿Puedo usarla sin escribir código?
Sí. La app de QRCodeKIT para Zapier tiene los disparadores New Scan, New Lead y New Payment, Make y n8n reciben webhooks, y el servidor MCP permite que Claude, ChatGPT y otros asistentes de IA gestionen tus códigos desde un chat.
