API referencia

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/odpovedí, idempotencia, stránkovanie.

Autentifikácia API kľúče, hlavičky 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 priamo 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 Workspaces Účty, Workspaces, členstvá a limity plánov.

Webhooks Prihlásenie na odber udalostí, overovanie podpisov, záznamy o doručení.

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

Ochrana osobných údajov & Privacy endpointy GDPR export, vymazanie účtov, hashovanie IP adries, súhlasy.

Verziovanie & Deprecation Wie neue Felder eingeführt werden und was Breaking Changes auslöst.

Endpointy špecifické pre DPP

Všetky endpointy pre digitálny pas produktu (Digital Product Passport) sú zdokumentované vo vlastnej sekcii Digital Product Passport — vrátane referenčných schém pre batérie a textil, validátora súladu s predpismi EÚ 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 je k dispozícii na adrese https://qr3.app/v1/openapi.json a automaticky sa aktualizuje pri každom nasadení (deploy).