GETMéthode GET/passport/{identifier}/proof

Code HTTP 200.

{
  "passport_version": 3,
  "data_hash": "1111111111111111111111111111111111111111111111111111111111111111",
  "ipfs_uri": "ipfs://bafybeiexemple00000000000000000000000000000000000000000000",
  "ipfs_gateway_url": "https://ipfs.io/ipfs/bafybeiexemple00000000000000000000000000000000000000000000",
  "anchor": {
    "chain": "base",
    "chain_id": 8453,
    "type": "merkle_batch",
    "tx_hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
    "basescan_url": "https://basescan.org/tx/0x2222222222222222222222222222222222222222222222222222222222222222",
    "merkle_root": "0x3333333333333333333333333333333333333333333333333333333333333333",
    "anchored": true,
    "proves": "batch_inclusion"
  },
  "passport_anchor": {
    "chain": "base",
    "chain_id": 8453,
    "tx_hash": "0x4444444444444444444444444444444444444444444444444444444444444444",
    "basescan_url": "https://basescan.org/tx/0x4444444444444444444444444444444444444444444444444444444444444444",
    "merkle_root": "0x5555555555555555555555555555555555555555555555555555555555555555",
    "leaf": "0x6666666666666666666666666666666666666666666666666666666666666666",
    "leaf_index": 2,
    "proof": [
      "0x7777777777777777777777777777777777777777777777777777777777777777",
      "0x8888888888888888888888888888888888888888888888888888888888888888"
    ],
    "anchored_at": "2026-08-14T02:15:09+00:00",
    "data_hash_matches": true,
    "proves": "content_existed_at_or_before_tx"
  },
  "seal": {
    "sealed": true,
    "sealed_at": "2026-08-13T09:41:22+00:00",
    "algorithm": "st-dpp-chain-v1",
    "version_hash": "9999999999999999999999999999999999999999999999999999999999999999",
    "prev_version_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "linked": true,
    "chain_link_match": true
  },
  "vc": {
    "issued": true,
    "vct": "https://schema.sealtrust.io/vct/digital-product-passport",
    "issued_at": "2026-08-13T09:41:25+00:00"
  },
  "verifications": {
    "count": 47,
    "last_verified_at": "2026-08-19T18:03:44+00:00"
  }
}

passport_version, seal et vc sont toujours présents. Nous omettons les autres champs de premier niveau quand la preuve correspondante n'existe pas. Une absence signifie que cette preuve n'est pas disponible. Traitez-la comme une information, au même titre qu'une valeur.

Le passeport servi ici porte soit sur cet exemplaire précis, soit sur son modèle. Nous cherchons d'abord un passeport rattaché à l'exemplaire. À défaut, nous servons le passeport publié pour son modèle, partagé par tous les exemplaires qui portent le même code produit. Dans ce second cas, data_hash, ipfs_uri, ipfs_gateway_url, passport_anchor, seal et vc décrivent le document du modèle. anchor et verifications restent propres à l'exemplaire que vous avez demandé.

La réponse porte aussi l'en-tête Cache-Control: no-store, max-age=0. Ne mettez cette réponse dans aucun cache partagé. Pour réduire le nombre de vos appels, gardez le résultat dans votre propre cache applicatif, avec la durée de fraîcheur que votre usage tolère.

#Le bloc anchor, la référence de l'article

Ce bloc est présent quand l'article porte une référence sur la chaîne. Il recouvre deux situations différentes, et c'est le champ anchored qui les sépare.

anchored: true veut dire que le lot auquel appartient l'article a été inscrit sur la chaîne. Vous obtenez la preuve d'appartenance elle-même par GET /v1/verify/merkle/{identifier}, lorsque ce bloc porte aussi merkle_root. Sans merkle_root, cet appel répond 404 et detail vaut No Merkle anchor for this product.

anchored: false veut dire que le lot de l'article n'a jamais été inscrit. Le bloc porte alors la transaction de frappe de l'article. Elle démontre que le jeton existe sur la chaîne. Elle ne démontre rien sur un lot, et rien sur le contenu du passeport.

Dans les deux cas, cette référence ne porte aucun engagement sur le contenu du passeport. L'engagement sur le contenu se lit dans passport_anchor et dans seal.

#Le bloc passport_anchor, la date du document

Ce bloc est présent quand cette version précise du passeport a été inscrite sur la chaîne. Il établit une seule chose : le contenu existait au plus tard au moment de cette transaction.

Vous pouvez refaire la vérification d'appartenance sans nous faire confiance. Vous partez de leaf. Pour chaque élément de proof, dans l'ordre, vous mettez les deux valeurs de 32 octets côte à côte, la plus petite des deux d'abord, puis vous appliquez keccak256 à la concaténation. Le résultat devient la nouvelle valeur de travail. Après le dernier élément de proof, vous devez obtenir exactement merkle_root. C'est la convention de vérification d'OpenZeppelin, avec des voisins triés à chaque étage. Ouvrez ensuite basescan_url pour lire la transaction qui a inscrit cette racine.

L'absence de passport_anchor est courante et normale. Publier une version ne l'inscrit pas sur la chaîne. L'inscription est une opération distincte, faite par passages groupés, et beaucoup de passeports publiés ne portent jamais ce bloc. Ne concluez donc rien de son absence sur la validité du passeport. Le bloc seal, lui, est toujours présent et couvre les versions non inscrites.

#Le bloc seal, le sceau de la version

Ce bloc est toujours présent. Il tient sur les versions que passport_anchor ne couvre pas.

chain_link_match est recalculé à chaque appel à partir du contenu enregistré. false veut dire que la version a été modifiée après sa publication.

#Le bloc vc, le justificatif signé

Ce bloc est toujours présent.

#La copie IPFS

ipfs_uri et ipfs_gateway_url désignent la copie publique du passeport. Le contenu à cette adresse est la vue publique du passeport. Son empreinte diffère donc de data_hash, qui porte sur le contenu complet.

Vous ne recevez ces deux champs que lorsque nous avons récupéré la copie et vérifié qu'elle est exactement le passeport public que la marque publie aujourd'hui. Leur absence peut donc signifier trois choses : aucune copie n'a été déposée, la copie n'a pas pu être récupérée au moment de l'appel, ou son contenu ne correspond plus à ce que la marque publie. Une marque qui change ses règles d'accès change ce que montre son passeport public, donc une copie déposée avant ce changement cesse d'être annoncée tant qu'une nouvelle n'a pas été déposée. Ne concluez rien de leur seule absence.

L'hôte de ipfs_gateway_url est celui d'une passerelle publique et peut changer. Ne le codez pas en dur. Utilisez l'adresse rendue telle quelle, ou ipfs_uri avec la passerelle de votre choix.