Primeros pasos
Primeros pasos
¿Eres nuevo en qr3.app? Esta guía te llevará a través de los conceptos básicos en unos 5 minutos, ya sea que quieras crear enlaces cortos dinámicos, análisis de QR o un EU Digital Product Passport.
Ruta recomendada
- Introducción — Qué es qr3.app, qué productos existen (Codes, DPPs, Resolver, Agent-Skills) y cómo está estructurado el stack.
- Inicio rápido — Pasos con
curldesde la primera API-Key hasta el primer código QR listo, incluyendo la prueba de redirección. - Autenticación — Crear API-Keys, configurar cabeceras de Workspace, gestionar secretos locales.
- SDKs, CLI y MCP — SDK de TypeScript, CLI (
npx @qr3/cli) y el servidor MCP para AI-Agents.
Ir directamente al caso de uso
Crear código QR dinámico POST /v1/codes, comprobación rápida de redirección y primer evento de escaneo en el panel de control.
Crear Digital Product Passport Baterías, textiles y validador de conformidad de la UE a través de la misma API.
Imprimir recurso QR (SVG/PDF/EPS) PDF vectorial (RGB), SVG, PNG y EPS en /v1/codes/:id/qr.*
Conectar AI-Agent (MCP) create_dpp_qr y otras herramientas, directamente desde Claude, Cursor o Codex.
Lo que necesitas tener a mano
- Una cuenta en app.qr3.app/sign-up (incluye espacio de trabajo de prueba).
- Una API-Key (Panel de control → Configuración → API-Keys) con el formato
qr3_sk_…. - Para los DPPs, adicionalmente un GTIN y un número de serie/lote. Quien (aún) no tenga un GTIN propio, puede usar el modo interno
BYO-GTIN(ver Onboarding de GS1).
Ayuda y referencias
- Referencia de la API — todos los endpoints con ejemplos de solicitud/respuesta.
- OpenAPI interactiva — pruébalo directamente en el navegador, la autenticación se guarda en el frontmatter.
- Referencia de errores — tipos de problemas RFC-7807 con sugerencias de solución.
- Changelog — notas de lanzamiento de la API pública.