Referencia de la API

La API REST de qr3.app está disponible en https://qr3.app/v1/ y sigue estrictamente las convenciones de la Resumen de la API (autenticación mediante Authorization: Bearer, errores según RFC 7807, paginación por cursor).

Introducción

Resumen de la API Versionado, formato de petición/respuesta, idempotencia, paginación.

Autenticación Claves de API, cabeceras de espacio de trabajo, entorno de prueba vs. producción.

Referencia de errores Tipos de error RFC 7807 con códigos de estado y ejemplos.

Referencia interactiva OpenAPI 3.1 + Scalar-Playground — introduzca tokens y pruébelo directamente.

Áreas de recursos

Códigos QR Crear, actualizar, rastrear y redirigir de forma segura códigos dinámicos y estáticos.

Organizaciones y espacios de trabajo Cuentas, espacios de trabajo, membresías y límites de planes.

Webhooks Suscripción a eventos, verificación de firmas, registros de entrega.

MCP y agentes Model Context Protocol — generar códigos QR y DPPs desde agentes de IA.

Protección de datos y endpoints de privacidad Exportación RGPD, eliminación de cuentas, hash de IP, consentimientos.

Versionado y obsolescencia Cómo se introducen nuevos campos y qué desencadena cambios disruptivos.

Endpoints específicos de DPP

Todos los endpoints del Digital Product Passport están documentados en su propia sección Digital Product Passport, incluyendo referencias de esquemas para baterías y textiles, el validador de conformidad de la UE y el resolver público de GS1.

URLs base por entorno

Entorno	URL base	Propósito
Production	`https://qr3.app/v1/`	API pública en vivo
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Piloto de preproducción (ver `ENVIRONMENTS.md`)
Local	`http://localhost:8787/v1/`	`pnpm --filter api dev`

La especificación OpenAPI está disponible en https://qr3.app/v1/openapi.json y se actualiza automáticamente con cada despliegue.