Vai al contenuto

Letture pubbliche dei passaporti

Letture pubbliche dei passaporti

Chiunque può leggere un passaporto pubblicato con questi tre metodi. Non richiedono alcuna chiave API. Usano i percorsi della EN 18222, la norma europea per le API dei passaporti.

Indirizzo di base

Ogni metodo parte da https://passportcraft.com. Il dominio dei passaporti di un marchio risponde agli stessi metodi per i passaporti di quel marchio.

Quando un registro chiede l'endpoint API di un passaporto (dppApiEndpoint nella EN 18222), indichi questo indirizzo di base.

https://passportcraft.com

Metodi

  • GET/v1/dpps/{dppId}

    Leggere un passaporto tramite il suo identificativo.

  • GET/v1/dppsByProductId/{productId}

    Leggere il passaporto di un prodotto.

  • POST/v1/dppsByProductIds

    Trovare gli identificativi dei passaporti di più prodotti.

Richiesta
curl "https://passportcraft.com/v1/dpps/https%3A%2F%2Fpassportcraft.com%2Fpassport%2F{id}"
Risposta
{
  "digitalProductPassportId": "https://passportcraft.com/passport/{id}",
  "uniqueProductIdentifier": "https://passportcraft.com/01/{gtin}",
  "granularity": "model",
  "dppSchemaVersion": "EN18223:v1.0",
  "dppStatus": "active",
  "lastUpdated": "2026-01-01T00:00:00Z"
}

Identificativi

dppId è il digitalProductPassportId del passaporto, in codifica percentuale. Funziona anche il solo identificativo del passaporto.

productId è l'uniqueProductIdentifier del passaporto, in codifica percentuale. È il suo GS1 Digital Link oppure, se il prodotto non ha un codice a barre, l'indirizzo del suo passaporto.

Invii fino a 500 identificativi di prodotto come array JSON nel corpo della richiesta. Invii ogni identificativo esattamente come lo riporta il passaporto. Non aggiunga la codifica percentuale di cui hanno bisogno i due metodi GET. La risposta elenca gli identificativi dei passaporti trovati, nell'ordine in cui li ha inviati. Un identificativo di prodotto che non corrisponde ad alcun passaporto pubblicato viene omesso.

limit stabilisce quanti identificativi di prodotto legge una pagina, da 1 a 100. Senza limit, una pagina ne legge 50. Finché ne restano altri, paging_metadata.cursor contiene il valore da inviare come cursor per la pagina successiva.

Rappresentazione

Il passaporto arriva per impostazione predefinita in forma compressa. Aggiunga ?representation=full per ottenere la forma completa, che indica il tipo di ogni elemento.

Browser

Una richiesta che preferisce l'HTML, come quella di un browser, viene reindirizzata alla pagina del passaporto.

Codici di stato

200Il passaporto, oppure l'elenco degli identificativi dei passaporti.
303Un reindirizzamento alla pagina del passaporto, per un browser.
400L'identificativo, l'identificativo di prodotto, il corpo della richiesta o un valore di query non è valido.
404Nessun passaporto pubblicato corrisponde.
405Questo percorso non accetta questo metodo.
500Al momento non è stato possibile leggere il passaporto. Riprovi tra poco.
501La EN 18222 definisce questo metodo e noi non lo offriamo.

Ogni errore tranne 501 contiene un oggetto result. Contiene un elenco di messaggi, ciascuno con messageType, text, code e timestamp. I programmi devono leggere code, che non cambia mai.

Questi metodi servono solo a leggere. Per creare o modificare passaporti, usi le API autenticate.