§DEVELOPERS
¿Cómo integrar la generación de QR en tu aplicación?
La API REST de codigo-qr.es genera QR estáticos y dinámicos, los gestiona y devuelve imágenes PNG o SVG desde cualquier lenguaje con una sola llamada.
Requiere plan Pro
¿Puedo usar la API sin registrarme?
Sí. El endpoint público genera QR estáticos sin cuenta y sin API key, con un límite de 50 peticiones al día por IP.
Usa POST /api/v1/qr/render con el contenido del QR, el formato y el tamaño. Recibes la imagen en base64. Sin registro, sin tarjeta de crédito.
Ejemplo sin autenticación
curl -X POST https://codigo-qr.es/api/v1/qr/render \
-H "Content-Type: application/json" \
-d '{"value":"https://yourdomain.com","format":"png","size":512}'¿Cómo funciona la autenticación de la API?
La API Pro usa API keys en el header Authorization. La key se genera en /panel/cuenta y es exclusiva del plan Pro activo.
Añade el token en el header Authorization: Bearer de cada petición Pro. La key se genera desde /panel/cuenta en un clic y se puede revocar en cualquier momento sin afectar al QR ya impreso.
Ejemplo con API key
curl https://codigo-qr.es/api/v1/qr \
-H "Authorization: Bearer cqr_your_token_here"La API key requiere plan Pro activo. Ver planes y precios
¿Qué endpoints tiene la API de código QR?
Ocho endpoints: uno público sin auth para generación inmediata, y siete Pro para crear, listar, actualizar, eliminar, descargar imagen y ver estadísticas.
| Método | Ruta | Para qué sirve | Plan |
|---|---|---|---|
| POST | /api/v1/qr/render | Genera un QR y devuelve la imagen en base64. Sin auth. | Público |
| GET | /api/v1/qr | Lista todos tus QR con paginación. | Pro |
| POST | /api/v1/qr | Crea un QR estático o dinámico. | Pro |
| GET | /api/v1/qr/{id} | Devuelve el detalle completo de un QR. | Pro |
| PATCH | /api/v1/qr/{id} | Actualiza el destino, el nombre o el estado. | Pro |
| DELETE | /api/v1/qr/{id} | Elimina un QR (borrado suave, reversible). | Pro |
| GET | /api/v1/qr/{id}/image | Descarga la imagen PNG o SVG del QR. | Pro |
| GET | /api/v1/qr/{id}/stats | Estadísticas de escaneos por día y por país. | Pro |
¿Para qué se usa la API de QR en un negocio?
Ecommerce, restaurantes, eventos y logística la usan para automatizar la generación de QR en documentos y sistemas, sin intervención manual.
Ecommerce
El ERP genera un QR por albarán con el enlace de seguimiento. Si cambia la URL, PATCH actualiza el destino sin reimprimir el código.
Restaurantes
El POS crea un QR por mesa al abrir el turno. El chef actualiza la carta en el CMS; el QR redirige siempre a la versión actual.
Eventos
El sistema de ticketing genera un QR único por entrada. En la puerta, el scanner verifica el QR leyendo la API y confirma si es válido.
Logística
Cada paquete lleva un QR que apunta a su página de seguimiento. Los escaneos quedan en GET /api/v1/qr/{id}/stats.
¿Cuántas peticiones permite la API de QR?
El endpoint público acepta 50 peticiones al día por IP. Los endpoints Pro permiten 60 peticiones por minuto y usuario con API key.
Cuando superas el límite la API devuelve 429 con los headers X-RateLimit-Limit, X-RateLimit-Remaining y Retry-After para saber cuándo reintentar.
Público
50
req / day / IP
Pro
60
req / min / user
Preguntas frecuentes sobre la API de QR
El endpoint público es gratuito, con límite de 50 peticiones al día por IP. La API completa, con API key, CRUD, imagen y estadísticas, requiere plan Pro a 5,99€/mes.
PNG y SVG. Usa el parámetro format=png o format=svg. Los tamaños disponibles son 256, 512 y 1024 píxeles para la descarga.
Sí. PATCH /api/v1/qr/{id} actualiza la URL destino en cualquier momento. El código QR impreso permanece igual; solo cambia el destino al que redirige.
Solo se guarda el hash SHA-256 del token, nunca el token en claro. Se muestra una sola vez al generarlo. Puedes revocar la key desde /panel/cuenta en cualquier momento.
Todavía no. La API es REST estándar y funciona con cualquier cliente HTTP: curl, fetch, axios, requests de Python, Guzzle de PHP y similares.
Empieza a integrar la API de QR hoy
Crea tu cuenta, activa el plan Pro y genera tu primera API key en menos de 2 minutos.