API-referentie

De qr3.app REST-API is bereikbaar via https://qr3.app/v1/ en volgt consistent de conventies uit het API-overzicht (authenticatie via Authorization: Bearer, fouten volgens RFC 7807, cursor-paginering).

Aan de slag

API-overzicht Versiebeheer, request-/response-formaat, idempotentie, paginering.

Authenticatie API-keys, workspace-headers, test- vs. live-omgeving.

Foutreferentie RFC 7807-fouttypen met statuscodes en voorbeelden.

Interactieve referentie OpenAPI 3.1 + Scalar-playground — tokens invoeren en direct testen.

Resource-secties

QR-codes Dynamische & statische codes aanmaken, bijwerken, tracken en veilig omleiten.

Organisaties & Workspaces Accounts, workspaces, lidmaatschappen en planlimieten.

Webhooks Abonneren op events, handtekeningverificatie, delivery logs.

MCP & Agents Model Context Protocol — QR-codes en DPP's genereren vanuit AI-agents.

Gegevensbescherming & Privacy-endpoints AVG-export, accounts verwijderen, IP-hashing, consents.

Versiebeheer & Deprecation Hoe nieuwe velden worden geïntroduceerd en wat breaking changes veroorzaakt.

DPP-specifieke endpoints

Alle Digital-Product-Passport-endpoints zijn gedocumenteerd in de eigen sectie Digital Product Passport — inclusief schema-referenties voor batterijen en textiel, EU-compliance-validator en de openbare GS1-resolver.

Basis-URL’s per omgeving

Omgeving	Basis-URL	Doel
Production	`https://qr3.app/v1/`	Openbare live-API
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Pre-production pilot (zie `ENVIRONMENTS.md`)
Lokaal	`http://localhost:8787/v1/`	`pnpm --filter api dev`

De OpenAPI-specificatie is te vinden op https://qr3.app/v1/openapi.json und wird bei jedem Deploy automatisch aktualisiert.