La REST API y los webhooks ya están disponibles
Crea códigos QR y enlaces cortos desde tus sistemas con claves y ámbitos de API.
- Claves con prefijo qrw_live_
- 300 solicitudes por minuto y clave
- Webhooks para cambios de enlaces
curl -X POST https://app.smartqrcodes.io/api/v1/qr-codes \ -H "Authorization: Bearer qrw_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Autumn menu", "type": "URL", "content": "https://cafe.example/menu", "isDynamic": true, "slug": "autumn" }'→ 201 Created{ "id": "8b1e27d3-2b57-4b6f-b6c4-a9f6cf79ea31", "shortLink": { "slug": "autumn" }, "isActive": true }
La clave API se limita a los permisos elegidos. Guarda el secreto completo al crear la clave.
Disponibilidad de funciones
Qué funciona ahora
/api/v1 usa claves API qrw_live_… con autenticación Bearer y scopes. El límite es de 300 solicitudes por minuto para cada clave.
Claves con prefijo qrw_live_
El secreto completo solo se muestra al crear o rotar la clave. Guárdelo enseguida en un almacenamiento seguro y, si lo pierde, rote la clave.
300 solicitudes por minuto y clave
Los scopes de la clave API definen los recursos y operaciones disponibles. Cada solicitud se comprueba por separado.
Webhooks para cambios de enlaces
Crea códigos QR y enlaces cortos desde tus sistemas con claves y ámbitos de API.
Qué ofrece la API actual
Los scopes de la clave API definen los recursos y operaciones disponibles. Cada solicitud se comprueba por separado.
Autenticación por scopes
La clave se envía como Authorization: Bearer qrw_live_… y accede solo a los recursos y las operaciones permitidos.
Minisitios y proyectos
Los scopes de lectura y escritura independientes permiten dar a la integración solo los permisos necesarios.
Aislamiento de solicitudes
Cada solicitud se autoriza de forma independiente según la clave API y sus scopes.
Ciclo de vida de la clave
La clave se puede crear, configurar, rotar y revocar; el secreto completo no se devuelve en la lista de claves.
El límite de la documentación
La referencia de rutas y los ejemplos de solicitudes están en su panel; los archivos OpenAPI, el SDK oficial y las bibliotecas cliente aún no se han publicado.
El secreto de la clave se muestra una sola vez
La rotación revoca la clave anterior y emite una de reemplazo; la revocación interrumpe cualquier autorización posterior con esa clave.
Autenticación Bearer con clave API
Envíe una clave con el prefijo qrw_live_… en el encabezado Authorization: Bearer. Los scopes limitan las operaciones disponibles y cada clave admite 300 solicitudes por minuto.
- Creación, consulta y configuración de claves de API
- Rotación y revocación de claves
- El secreto completo se muestra una sola vez
- Authorization: Bearer qrw_live_…
Authorization: Bearer qrw_live_YOUR_KEY
El secreto completo solo se muestra al crear o rotar la clave. Guárdelo enseguida en un almacenamiento seguro y, si lo pierde, rote la clave.
Contrato de solicitud de la API
La tabla reúne los parámetros obligatorios de la API externa actual.
| Contrato de solicitud de la API | Requisito | API actual |
|---|---|---|
| Autenticación | Clave API | Bearer qrw_live_… |
| Cabecera | Authorization | Bearer qrw_live_… |
| Control de acceso | Scopes de la clave API | Se comprueban en cada solicitud |
| Límite de solicitudes | Por clave API | 300 solicitudes por minuto |
- Autenticación
- Requisito
- Clave API
- API actual
- Bearer qrw_live_…
- Cabecera
- Requisito
- Authorization
- API actual
- Bearer qrw_live_…
- Control de acceso
- Requisito
- Scopes de la clave API
- API actual
- Se comprueban en cada solicitud
- Límite de solicitudes
- Requisito
- Por clave API
- API actual
- 300 solicitudes por minuto
Inicio rápido
Cómo conectar una integración de servidor
Cree una clave con los permisos mínimos, guarde el secreto que se muestra una sola vez y transmítalo solo desde un entorno de confianza.
- 1
Cree la clave
Obtenga una clave para la integración de servidor, asigne los scopes mínimos necesarios y guarde el secreto en un lugar protegido.
- 2
Elija los scopes
Deje solo los permisos de lectura y escritura que la integración necesita de verdad.
- 3
Guarde el secreto
Copie el secreto de inmediato: no se vuelve a mostrar. Si lo pierde, rote la clave.
- 4
Envíe la cabecera
Use Authorization: Bearer qrw_live_… en una ruta /api/v1 admitida.
FAQ
Preguntas frecuentes
¿Qué formato tiene una clave API?
La clave comienza por qrw_live_…. Guarde el secreto completo en un entorno de servidor protegido y no lo exponga en código cliente.
¿Cómo se envía la clave de API?
Envíe la clave en el encabezado Authorization como credencial Bearer o en el encabezado X-API-Key. El acceso se limita a los scopes de la clave.
¿Qué límite de solicitudes se aplica?
Cada clave API está limitada a 300 solicitudes por minuto.
¿Qué eventos envían los webhooks?
Los webhooks se envían al crear, actualizar o eliminar un enlace corto: link.created, link.updated y link.deleted.
Cree una clave para su integración de servidor
Elija los scopes mínimos, guarde el secreto al emitirlo y úselo solo en un entorno de confianza.