Riferimento API

L’API REST di qr3.app è raggiungibile all’indirizzo https://qr3.app/v1/ e segue interamente le convenzioni descritte nella Panoramica delle API (autenticazione tramite Authorization: Bearer, errori secondo RFC 7807, paginazione tramite cursori).

Per iniziare

Panoramica delle API Versionamento, formato di richiesta/risposta, idempotenza, paginazione.

Autenticazione Chiavi API, header del Workspace, ambiente di test vs. live.

Riferimento errori Tipi di errore RFC 7807 con codici di stato ed esempi.

Riferimento interattivo OpenAPI 3.1 + Scalar Playground — inserisci i token e testa direttamente.

Aree delle risorse

Codici QR Creazione, aggiornamento, tracciamento e reindirizzamento sicuro di codici dinamici e statici.

Organizzazioni e Workspace Account, Workspace, iscrizioni e limiti del piano.

Webhook Sottoscrizione agli eventi, verifica delle firme, log di invio.

MCP e agenti Model Context Protocol — generazione di codici QR e DPP da agenti AI.

Protezione dei dati ed endpoint per la privacy Esportazione GDPR, eliminazione account, hashing IP, consensi.

Versionamento e deprecazione Come vengono introdotti i nuovi campi e cosa causa modifiche di rottura (breaking changes).

Endpoint specifici per DPP

Tutti gli endpoint del Digital Product Passport sono documentati nella sezione dedicata Digital Product Passport — inclusi i riferimenti agli schemi per batterie e tessili, il validatore di conformità UE e il resolver GS1 pubblico.

URL di base per ambiente

Ambiente	URL di base	Scopo
Production	`https://qr3.app/v1/`	API live pubblica
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Pilota di pre-produzione (vedi `ENVIRONMENTS.md`)
Locale	`http://localhost:8787/v1/`	`pnpm --filter api dev`

La specifica OpenAPI è disponibile all’indirizzo https://qr3.app/v1/openapi.json e viene aggiornata automaticamente a ogni deploy.