API referenca

REST API za qr3.app je dostupan na https://qr3.app/v1/ i u potpunosti slijedi konvencije iz Pregleda API-ja (autentifikacija putem Authorization: Bearer, pogreške prema RFC 7807, Cursor-Pagination).

Početak

Pregled API-ja Verzioniranje, format zahtjeva/odgovora, idempotencija, paginacija.

Autentifikacija API ključevi, zaglavlja radnog prostora, testno naspram produkcijskog okruženja.

Referenca pogrešaka RFC 7807 tipovi pogrešaka sa statusnim kodovima i primjerima.

Interaktivna referenca OpenAPI 3.1 + Scalar igralište — unesite tokene i testirajte izravno.

Područja resursa

QR kodovi Stvaranje, ažuriranje, praćenje i sigurno preusmjeravanje dinamičkih i statičkih kodova.

Organizacije i radni prostori Korisnički računi, radni prostori, članstva i ograničenja paketa.

Webhooks Pretplata na događaje, verifikacija potpisa, zapisi o isporuci.

MCP & Agents Model Context Protocol — stvaranje QR kodova i DPP-ova iz AI agenata.

Zaštita podataka i krajnje točke privatnosti GDPR izvoz, brisanje računa, IP sažimanje (hashing), privole.

Verzioniranje i zastarjelost Kako se uvode nova polja i što uzrokuje prijelomne promjene.

Krajnje točke specifične za DPP

Sve krajnje točke za Digital Product Passport dokumentirane su u zasebnom odjeljku Digital Product Passport — uključujući reference shema za baterije i tekstil, validator usklađenosti s EU propisima te javni GS1 razlučitelj (resolver).

Osnovni URL-ovi po okruženju

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

OpenAPI specifikacija nalazi se na https://qr3.app/v1/openapi.json i automatski se ažurira pri svakom postavljanju (deploy).