/api/v1/products/{id}/links/model-qrRenderizzare il QR della pagina del modello
Renderizza il codice QR della pagina del modello del prodotto, l'indirizzo GS1 semplice /01/{gtin} elencato in GET /api/v1/products/{id}/links. La pagina del modello mostra solo i valori pubblici identici in ogni unità pubblicata, quindi il codice è adatto a un annuncio online o a un rivenditore; ogni unità mantiene il proprio passaporto. Nero su sfondo trasparente. Conta come una lettura v1.
Risponde 404 model_not_found quando il prodotto non ha un passaporto GS1 pubblicato con quel GTIN (quindi nessuna pagina del modello), 400 invalid_gtin quando gtin non è di 14 cifre e 400 gtin_required quando i passaporti pubblicati del prodotto riportano più di un GTIN e gtin manca.
Parametri di percorso
- idobbligatorio
string (24 hex chars)
ID del prodotto.
e.g. 6650a1b2c3d4e5f6a7b8c9d0
Parametri di query
- format
string
svg(default) opng.e.g. png
- gtin
string (14 digits)
Necessario solo quando i passaporti pubblicati del prodotto riportano più di un GTIN.
e.g. 09506000134352
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Richiesta
# SVG (default)
curl -sS https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.svg
# PNG for one GTIN
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?format=png>in=09506000134352" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.pngRisposta
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
<!-- QR modules encoding https://id.tracepass.eu/01/<gtin> -->
</svg>