La API REST v1 de QRbanner te permite crear, actualizar y organizar códigos QR desde scripts, backends y pipelines de CI. Las claves API están disponibles en el plan gratuito — sin llamada comercial.
Crear una clave API
- Inicia sesión y abre Dashboard → Settings → API Keys
- Crea una clave con un nombre descriptivo (p. ej. «Production backend»)
- Copia la clave una sola vez — solo se muestra al crearla
- Envíala como Authorization: Bearer o X-API-Key en cada petición
Crea tu primer código QR
POST /api/v1/qr con un cuerpo JSON que incluya name, category y qr_data. Los códigos URL necesitan { "url": "https://..." }. La respuesta incluye short_code y la URL de escaneo.
Recibir webhooks de escaneo
Añade un endpoint HTTPS en Settings → Scan Webhooks. Cada escaneo hace POST de JSON con event, qr_code_id y metadatos del escaneo. Verifica X-QRbanner-Signature con HMAC-SHA256 usando el secreto del webhook. Consulta el historial de entregas en el mismo panel.
Especificación OpenAPI
Descarga openapi.json desde /developers o /api/openapi.json para importar la API REST v1 en Postman, Insomnia o tu API gateway — incluye esquemas de QR, carpetas y webhooks.