TracePass
Inizia ora
Passaporti

Renderizzare il QR del passaporto

Restituisce un codice QR appena renderizzato per il passaporto, che codifica il suo URI identificatore effettivo. Per i passaporti GS1 è il GS1 Digital Link URI (/01/<gtin>/21/<serial>); per ISO 15459 è il percorso del resolver; per i passaporti iec61406, did e doi è il percorso resolver /x/<scheme>/<encodedValue> (es. https://id.tracepass.eu/x/did/<encodedDid>). Tutti e cinque gli schemi EN 18219 si risolvono nello stesso viewer pubblico. Usatelo quando volete il nostro renderer (quiet zone coerente, correzione d'errore, branding facoltativo) invece di codificare voi l'URI. Il default è image/svg+xml; ?format=png restituisce un PNG e ?format=json un wrapper { result: "<svg>" } da incorporare.

GET/api/v1/passports/{id}/qr
Scarica OpenAPI 3.1
GET/api/v1/passports/{id}/qr

Renderizzare il QR del passaporto

Restituisce un codice QR appena renderizzato per il passaporto, che codifica il suo URI identificatore effettivo. Per i passaporti GS1 è il GS1 Digital Link URI (/01/<gtin>/21/<serial>); per ISO 15459 è il percorso del resolver; per i passaporti iec61406, did e doi è il percorso resolver /x/<scheme>/<encodedValue> (es. https://id.tracepass.eu/x/did/<encodedDid>). Tutti e cinque gli schemi EN 18219 si risolvono nello stesso viewer pubblico. Usatelo quando volete il nostro renderer (quiet zone coerente, correzione d'errore, branding facoltativo) invece di codificare voi l'URI. Il default è image/svg+xml; ?format=png restituisce un PNG e ?format=json un wrapper { result: "<svg>" } da incorporare.

Per default il QR è nero su sfondo trasparente. Impostate ?useCompanyBranding=true per usare il colore del marchio, oppure passate ?color=FF6600 (hex a 6 caratteri, senza #) per un primo piano esplicito — un color esplicito prevale sul branding. ?backgroundColor=FFFFFF aggiunge uno sfondo pieno (hex a 8 caratteri = RGBA per trasparenza parziale).

Indirizzamento alternativo: GET /api/v1/passports/by-serial/{serial}/qr accetta gli stessi parametri di query e il disambiguatore ?gtin= quando un seriale non è univoco tra i vostri GTIN. Ogni chiamata conta come una lettura di passaporto sul limite giornaliero.

Un passaporto creato nella dashboard senza identificatore di prodotto ("Aggiungilo dopo") non ha un codice QR finché l'identificatore non viene impostato: la chiamata risponde 409 identifier_required. I passaporti creati tramite API hanno sempre un identificatore.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID del passaporto.

Parametri di query

  • format

    string

    svg (default), png o json.

    e.g. png

  • symbology

    string

    qr (default) o datamatrix (ISO/IEC 16022). La EN 18220 ammette entrambi; entrambi codificano lo stesso URL del passaporto. Il Data Matrix è adatto a parti piccole e alla marcatura diretta.

    e.g. datamatrix

  • useCompanyBranding

    boolean

    Renderizza il QR nel colore del marchio invece del nero.

  • color

    string (hex, no #)

    Primo piano hex esplicito a 6 caratteri — prevale sul branding.

    e.g. FF6600

  • backgroundColor

    string (hex, no #)

    Sfondo pieno, hex a 6 o 8 caratteri (8 = RGBA).

    e.g. FFFFFF

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/passports/6650b2c3d4e5f6a7b8c9d0e1/qr \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o passport-qr.svg

# Branded PNG
curl -sS \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png&color=FF6600" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o passport-qr.png

# Data Matrix instead of QR (EN 18220 permits both)
curl -sS   "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png&symbology=datamatrix"   -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o passport-datamatrix.png

Risposta

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
  <!-- QR modules encoding the GS1 Digital Link URI -->
</svg>

Endpoint correlati