TracePass
Prodotti

Renderizzare 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.

GET/api/v1/products/{id}/links/model-qr
Scarica OpenAPI 3.1
GET/api/v1/products/{id}/links/model-qr

Renderizzare 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) o png.

    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 API tp_ (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&gtin=09506000134352" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.png

Risposta

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
  <!-- QR modules encoding https://id.tracepass.eu/01/<gtin> -->
</svg>