API referenca

REST API za qr3.app je dosegljiv na https://qr3.app/v1/ in dosledno sledi konvencijam iz pregleda API-ja (avtentikacija prek Authorization: Bearer, napake po RFC 7807, paginacija s kazalcem).

Začetek

Pregled API-ja Različice, oblika zahtevkov/odzivov, idempotenca, paginacija.

Avtentikacija API ključi, glave delovnih prostorov, testno vs. produkcijsko okolje.

Referenca napak Tipi napak RFC 7807 s statusnimi kodami in primeri.

Interaktivna referenca OpenAPI 3.1 + Scalar peskovnik — vnesite žetone in takoj preizkusite.

Področja virov

QR kode Ustvarjanje, posodabljanje, sledenje in varna preusmeritev dinamičnih in statičnih kod.

Organizacije in delovni prostori Računi, delovni prostori, članstva in omejitve paketov.

Webhooks Naročanje na dogodke, preverjanje podpisov, dnevniki dostave.

MCP in agenti Model Context Protocol — ustvarjanje QR kod in DPP-jev iz AI agentov.

Varstvo podatkov in končne točke zasebnosti Izvoz po GDPR, brisanje računov, zgoščevanje IP-jev, privolitve.

Različice in opuščanje Kako se uvajajo nova polja in kaj sproži prelomne spremembe.

Končne točke, specifične za DPP

Vse končne točke za Digital Product Passport so dokumentirane v lastnem razdelku Digital Product Passport — vključno s shematskimi referencami za baterije in tekstil, validatorjem skladnosti z EU ter javnim razreševalnikom GS1.

Osnovni URL-ji glede na okolje

Okolje	Osnovni URL	Namen
Production	`https://qr3.app/v1/`	Javni produkcijski API
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Predprodukcijski pilot (glejte `ENVIRONMENTS.md`)
Lokalno	`http://localhost:8787/v1/`	`pnpm --filter api dev`

Specifikacija OpenAPI se nahaja na https://qr3.app/v1/openapi.json in se samodejno posodobi ob vsaki namestitvi.