Referință API

API-ul REST qr3.app este accesibil la https://qr3.app/v1/ și respectă în totalitate convențiile din Prezentare generală API (autentificare prin Authorization: Bearer, erori conform RFC 7807, paginare prin cursor).

Primii pași

Prezentare generală API Versiune, format request/response, idempotență, paginare.

Autentificare Chei API, headere de Workspace, mediu de test vs. live.

Referință erori Tipuri de erori RFC 7807 cu coduri de stare și exemple.

Referință interactivă OpenAPI 3.1 + Scalar-Playground — introduceți tokenurile și testați direct.

Zone de resurse

Coduri QR Crearea, actualizarea, urmărirea și redirecționarea securizată a codurilor dinamice și statice.

Organizații și Workspaces Conturi, Workspaces, calitatea de membru și limitele planului.

Webhooks Abonarea la evenimente, verificarea semnăturii, loguri de livrare.

MCP & Agents Model Context Protocol — generarea de coduri QR și DPP-uri din agenți AI.

Protecția datelor și endpoint-uri de confidențialitate Export GDPR, ștergerea conturilor, hashing IP, consimțăminte.

Versiune și depreciere Cum sunt introduse câmpurile noi și ce anume declanșează breaking changes.

Endpoint-uri specifice DPP

Toate endpoint-urile pentru Digital Product Passport sunt documentate în secțiunea dedicată Digital Product Passport — inclusiv referințele de schemă pentru baterii și textile, validatorul de conformitate UE și resolverul public GS1.

URL-uri de bază per mediu

Mediu	URL de bază	Scop
Production	`https://qr3.app/v1/`	API live public
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Pilot pre-producție (consultați `ENVIRONMENTS.md`)
Local	`http://localhost:8787/v1/`	`pnpm --filter api dev`

Specificația OpenAPI este disponibilă la https://qr3.app/v1/openapi.json și este actualizată automat la fiecare deploy.