Lectures publiques de passeports

Méthodes

• GET/v1/dpps/{dppId}

  Lire un passeport à partir de son identifiant.

• GET/v1/dppsByProductId/{productId}

  Lire le passeport d'un produit.

• POST/v1/dppsByProductIds

  Trouver les identifiants de passeport de plusieurs produits.

curl "https://passportcraft.com/v1/dpps/https%3A%2F%2Fpassportcraft.com%2Fpassport%2F{id}"

{
  "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"
}

Identifiants

dppId est le digitalProductPassportId du passeport, encodé avec le codage pourcent. L'identifiant seul du passeport fonctionne aussi.

productId est le uniqueProductIdentifier du passeport, encodé avec le codage pourcent. C'est son GS1 Digital Link ou, si le produit n'a pas de code-barres, l'adresse de son passeport.

Envoyez jusqu'à 500 identifiants de produit sous forme de tableau JSON dans le corps de la requête. Envoyez chaque identifiant exactement tel que le passeport le donne. N'ajoutez pas le codage pourcent dont les deux méthodes GET ont besoin. La réponse liste les identifiants de passeport trouvés, dans l'ordre où vous les avez envoyés. Un identifiant de produit qui ne correspond à aucun passeport publié est omis.

limit fixe le nombre d'identifiants de produit lus par page, de 1 à 100. Sans limit, une page en lit 50. Tant qu'il en reste, paging_metadata.cursor contient la valeur à envoyer comme cursor pour la page suivante.

Représentation

Le passeport est fourni par défaut sous forme compressée. Ajoutez ?representation=full pour obtenir la forme complète, qui nomme le type de chaque élément.

Navigateurs

Une requête qui préfère le HTML, comme celle d'un navigateur, est redirigée vers la page du passeport.

Codes de statut

Toute erreur sauf 501 comporte un objet result. Il contient une liste de messages, chacun avec messageType, text, code et timestamp. Les programmes doivent lire code, qui ne change jamais.