TracePass
Inizia ora
Passaporti

Leggere un singolo passaporto

Legge un passaporto per ID. La risposta predefinita include il passaporto completo — i campi traducibili portano il loro `sourceLocale` e una mappa `translations` per locale. Passate `?lang=<locale>` per far risolvere al server ogni campo attraverso la catena del visualizzatore pubblico (traduzione nel locale del visualizzatore → valore del locale di origine → inglese → primo applicato → fonte universale) e restituire un valore risolto per campo; la mappa `translations` viene rimossa dalle risposte risolte per lang.

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

Leggere un singolo passaporto

Legge un passaporto per ID. La risposta predefinita include il passaporto completo — i campi traducibili portano il loro `sourceLocale` e una mappa `translations` per locale. Passate `?lang=<locale>` per far risolvere al server ogni campo attraverso la catena del visualizzatore pubblico (traduzione nel locale del visualizzatore → valore del locale di origine → inglese → primo applicato → fonte universale) e restituire un valore risolto per campo; la mappa `translations` viene rimossa dalle risposte risolte per lang.

Passate `?format=full` per includere inoltre etichette dei campi, unità di misura e livelli di accesso derivati dal template accanto a ogni valore — utile per costruire un visualizzatore personalizzato o un report di controllo. I due parametri di query si combinano: `?format=full&lang=de` restituisce le etichette in DE più i valori risolti in DE.

Indirizzamento alternativo: `GET /api/v1/passports/by-serial/{serial}` restituisce la stessa forma e accetta gli stessi parametri di query. Esiste anche un endpoint `GET /api/v1/passports/{id}/qr` che restituisce un SVG / PNG appena renderizzato del codice QR — utile quando volete il nostro renderer invece di codificare voi stessi `gs1.digitalLinkUri`.

Parametri di percorso

  • idobbligatorio

    ObjectId

    ID del passaporto.

Parametri di query

  • format

    string

    Impostate su `full` per includere etichette dei campi, unità di misura e livelli di accesso del template.

  • lang

    string (ISO 639-1)

    Risolve i valori dei campi a un singolo locale lato server. Uno dei 24 locale dell'UE.

Header

  • Authorizationobbligatorio

    string

    `Bearer <api-key>`.

Richiesta

# Default response — full data, consumer resolves locales itself
curl -sS https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# Single-locale response with template labels
curl -sS \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1?format=full&lang=de" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Risposta

{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "gs1": {
    "gtin": "04012345000015",
    "serialNumber": "BP-48V-100-000001",
    "digitalLinkUri": "https://id.tracepass.eu/p/01/04012345000015/21/BP-48V-100-000001"
  },
  "status": "published",
  "completionPercentage": 87,
  "fields": {
    "battery_chemistry": {
      "value": "lithium-ion",
      "source": "manual",
      "status": "approved",
      "accessLevel": "public",
      "sourceLocale": "en",
      "translations": {
        "de": { "value": "Lithium-Ionen", "source": "ai-haiku-4.5", "generatedAt": "2026-05-02T10:00:00.000Z" }
      }
    }
  }
}

Endpoint correlati