§DEVELOPERS
Com integrar la generació de QR a la teva aplicació?
L'API REST de codigo-qr.es genera codis QR estàtics i dinàmics, els gestiona i retorna imatges PNG o SVG des de qualsevol llenguatge amb una sola crida.
Requereix pla Pro
Puc usar l'API sense registrar-me?
Sí. L'endpoint públic genera codis QR estàtics sense compte i sense API key, amb un límit de 50 peticions al dia per IP.
Usa POST /api/v1/qr/render amb el contingut del QR, el format i la mida. Reps la imatge en base64. Sense registre ni targeta de crèdit.
Exemple sense autenticació
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}'Com funciona l'autenticació de l'API?
L'API Pro usa API keys a la capçalera Authorization. La key es genera a /panel/compte i és exclusiva del pla Pro actiu.
Afegeix la capçalera Authorization: Bearer amb el teu token a cada petició Pro. La key es genera des de /panel/compte amb un clic i es pot revocar en qualsevol moment.
Exemple amb API key
curl https://codigo-qr.es/api/v1/qr \
-H "Authorization: Bearer cqr_your_token_here"La API key requereix pla Pro actiu. Veure plans i preus
Quins endpoints té l'API de codis QR?
Vuit endpoints: un de públic sense auth per a generació immediata, i set Pro per crear, llistar, actualitzar, eliminar, descarregar imatge i veure estadístiques.
| Mètode | Ruta | Per a que serveix | Plan |
|---|---|---|---|
| POST | /api/v1/qr/render | Genera un QR i retorna la imatge en base64. Sense auth. | Públic |
| GET | /api/v1/qr | Llista tots els teus QR amb paginació. | Pro |
| POST | /api/v1/qr | Crea un QR estàtic o dinàmic. | Pro |
| GET | /api/v1/qr/{id} | Retorna el detall complet d'un QR. | Pro |
| PATCH | /api/v1/qr/{id} | Actualitza la destinació, el nom o l'estat. | Pro |
| DELETE | /api/v1/qr/{id} | Elimina un QR (esborrat suau, reversible). | Pro |
| GET | /api/v1/qr/{id}/image | Descarrega la imatge PNG o SVG del QR. | Pro |
| GET | /api/v1/qr/{id}/stats | Estadístiques d'escanejos per dia i per país. | Pro |
Per a que s'usa l'API de QR en un negoci?
Comerç electrònic, restaurants, esdeveniments i logística l'usen per automatitzar la generació de QR en documents i sistemes sense intervenció manual.
Comerç electrònic
L'ERP genera un QR per albarà amb l'enllaç de seguiment. Si canvia la URL, PATCH actualitza la destinació sense reimprimir el codi.
Restaurants
El TPV crea un QR per taula en obrir el torn. El cuiner actualitza la carta al CMS; el QR redirigeix sempre a la versió actual.
Esdeveniments
El sistema de ticketing genera un QR únic per entrada. A la porta, l'escàner verifica el QR via l'API i confirma si és vàlid.
Logística
Cada paquet porta un QR que apunta a la seva pàgina de seguiment. Els escanejos queden a GET /api/v1/qr/{id}/stats.
Quantes peticions permet l'API de QR?
L'endpoint públic accepta 50 peticions al dia per IP. Els endpoints Pro permeten 60 peticions per minut i usuari amb API key.
Quan superes el límit l'API retorna 429 amb les capçaleres X-RateLimit-Limit, X-RateLimit-Remaining i Retry-After per saber quan reintentar.
Públic
50
req / day / IP
Pro
60
req / min / user
Preguntes freqüents sobre l'API de QR
L'endpoint públic és graïtuït, amb límit de 50 peticions al dia per IP. L'API completa, amb API key, CRUD, imatge i estadístiques, requereix pla Pro a 5,99€/mes.
PNG i SVG. Usa el paràmetre format=png o format=svg. Les mides disponibles són 256, 512 i 1024 píxels.
Sí. PATCH /api/v1/qr/{id} actualitza la URL destinació en qualsevol moment. El codi QR imprès roman igual; només canvia la destinació.
Només es guarda el hash SHA-256 del token, mai el token en clar. Es mostra una sola vegada en generar-lo. Pots revocar la key des de /panel/compte.
Encara no. L'API és REST estàndard i funciona amb qualsevol client HTTP: curl, fetch, axios, requests de Python, Guzzle de PHP i similars.
Comença a integrar l'API de QR avui
Crea el teu compte, activa el pla Pro i genera la teva primera API key en menys de 2 minuts.