Funció
Gestiona els codis QR des del teu propi stack
Una API REST per crear, actualitzar i gestionar codis QR amb una clau d'API, més webhooks que notifiquen els teus sistemes quan es produeixen esdeveniments.
Escaneja’m
Què cobreix l'API
L'API pública admet operacions de creació, lectura, actualització i eliminació de QR. Està pensada per a aplicacions que necessiten proveir o mantenir registres QR com a part d'un flux de treball existent.
Un patró habitual és crear un registre QR quan es crea una comanda, un producte o una campanya, emmagatzemar l'identificador retornat i, després, actualitzar la destinació quan canvia el registre d'origen.
Crea un client fiable
- Emet una clau d'abast limitat. Dona a la integració només els permisos que necessita.
- Fes servir la idempotència. Les sol·licituds repetides no haurien de crear registres de producció duplicats.
- Gestiona les respostes d'error. Els errors segueixen els detalls de problema a l'estil RFC 9457.
- Pagina les sol·licituds de llista. No suposis que tots els registres es retornen en una sola resposta.
- Canvia les claus exposades. Tracta les credencials de l'API com qualsevol altre secret de producció.
Què queda fora de l'API pública
La superfície pública actual no exposa l'analítica del tauler, un flux de dades en cru per escaneig ni extrems públics de generació massiva. Les tasques massives per CSV existeixen a la interfície del producte. Els webhooks de sortida cobreixen els esdeveniments de cicle de vida admesos, però no s'emet cap webhook per a cada escaneig.
Usos pràctics
- Proveeix un QR de lloc web per a cada campanya nova.
- Crea registres de QR de producte o de PDF a partir d'un catàleg intern.
- Actualitza les destinacions quan una pàgina de document o de producte es mou.
- Posa un QR en pausa quan es retira un registre d'origen.
- Gestiona registres separats de llogater o de client amb el teu propi model de propietat.
Preguntes freqüents sobre l'API de codis QR
Què pot fer l'API?
Crear, llegir, actualitzar i eliminar registres de QR dinàmics a través de REST, amb claus d'API d'abast limitat i sol·licituds idempotents, de manera que els reintents no creïn mai duplicats.
Com m'autentico?
Amb una clau d'API d'abast limitat generada a la configuració del teu compte, enviada a cada sol·licitud. Canvia-la sempre que pugui haver quedat exposada.
Hi ha un límit de freqüència?
Sí: 120 sol·licituds per minut per clau. Business inclou fins a 100.000 sol·licituds d'API al mes; Enterprise és il·limitat. Starter i el nivell gratuït no inclouen accés a l'API.
Hi ha webhooks?
Sí: els webhooks cobreixen els esdeveniments de cicle de vida de QR, de subscripció, d'usuari i de lots. No hi ha cap webhook per escaneig.
L'API exposa l'analítica?
No: l'API pública és una superfície de gestió de QR. L'analítica d'escanejos resideix al tauler, on també la pots exportar.
Construeix amb Qrcado
Crea un compte, genera una clau d'API d'abast limitat i automatitza els teus codis.