Referencia API

REST API pre qr3.app je dostupné na adrese https://qr3.app/v1/ a dôsledne dodržiava konvencie z Prehľadu API (autentifikácia cez Authorization: Bearer, chyby podľa RFC 7807, stránkovanie pomocou kurzora).

Začíname

Prehľad API Verziovanie, formát požiadaviek a odpovedí, idempotencia, stránkovanie.

Autentifikácia API kľúče, hlavičky pracovného priestoru (Workspace), testovacie vs. produkčné prostredie.

Referencia chýb Typy chýb podľa RFC 7807 so stavovými kódmi a príkladmi.

Interaktívna referencia OpenAPI 3.1 + Scalar-Playground — zadajte tokeny a rovno testujte.

Oblasti zdrojov

QR kódy Vytváranie, aktualizácia, sledovanie a bezpečné presmerovanie dynamických a statických kódov.

Organizácie a pracovné priestory Účty, pracovné priestory (Workspaces), členstvá a limity programov.

Webhooky Prihlásenie na odber udalostí, overovanie podpisov, záznamy o doručení (Delivery-Logs).

MCP a agenti Model Context Protocol — generovanie QR kódov a DPP z AI agentov.

Ochrana osobných údajov a Privacy koncové body GDPR export, vymazanie účtov, hašovanie IP adries, súhlasy (Consents).

Verziovanie a zastarávanie (Deprecation) Ako sa zavádzajú nové polia a čo spôsobuje prelomové zmeny (Breaking Changes).

Koncové body špecifické pre DPP

Všetky koncové body pre digitálny pas produktu (Digital Product Passport) sú zdokumentované v samostatnej sekcii Digital Product Passport — vrátane referenčných schém pre batérie a textil, validátora súladu s predpismi EÚ (EU-Compliance-Validator) a verejného GS1 resolvera.

Základné URL pre jednotlivé prostredia

Prostredie	Základná URL	Účel
Production	`https://qr3.app/v1/`	Verejné produkčné API
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Predprodukčný pilot (pozri `ENVIRONMENTS.md`)
Lokálne	`http://localhost:8787/v1/`	`pnpm --filter api dev`

Špecifikácia OpenAPI sa nachádza na adrese https://qr3.app/v1/openapi.json a automaticky sa aktualizuje pri každom nasadení (Deploy).