GETMéthode GET/passport/{identifier}

Code HTTP 200.

Ce produit est encore au catalogue, il n'a pas été réclamé par un client, et le passeport est demandé au niveau public. Ses données ne décrivent aucune matière et ne déclarent aucune substance préoccupante, donc le bloc evidence ne note que l'exemplaire.

{
  "id": 1,
  "product_id": 1,
  "brand_code": "K7M2QF9XBN",
  "brand_id": 42,
  "schema_version": "1.0",
  "passport_version": 3,
  "data": {
    "product_identity": {
      "gtin": "03701234567891",
      "model": "Cartable Exemple 32",
      "brand": "Exemple SAS",
      "made_in": "FR"
    },
    "compliance": {
      "eu_espr": true,
      "reach": true,
      "ce_marking": false
    },
    "circularity": {
      "recyclability_percentage": 62,
      "recycled_content_percentage": 0
    }
  },
  "data_hash": "0000000000000000000000000000000000000000000000000000000000000000",
  "ipfs_uri": null,
  "ipfs_gateway_url": null,
  "visibility": "public",
  "access_tier": "public",
  "is_owner": false,
  "identity_included": true,
  "published_at": "2026-08-01T09:00:00+00:00",
  "product_name": "Cartable Exemple 32",
  "brand_name": "Exemple SAS",
  "image_url": "https://exemple-sas.test/images/cartable-32.jpg",
  "gtin": "03701234567891",
  "gs1_digital_link": "https://id.gs1.org/01/03701234567891/21/EXEMP1E00001",
  "passport_service_provider": null,
  "warranty": {
    "status": "active",
    "ends_at": "2028-08-01T09:00:00+00:00",
    "duration_months": 24,
    "transferable": true,
    "remaining_days": 730
  },
  "evidence": {
    "sections": {
      "identity": "verified",
      "integrity": "declared"
    },
    "legend": {
      "declared": "Stated by the brand. Recorded, dated and attributable, but not independently checked.",
      "verified": "Rests on an on-chain reference that anyone can re-check independently. SealTrust records it and does not re-query the chain on each request."
    },
    "derived": true,
    "note": "Statuses are computed by SealTrust from verifiable facts. A brand cannot set them."
  }
}

Le domaine du champ gs1_digital_link est celui du résolveur configuré pour votre intégration. https://id.gs1.org n'est que la valeur de repli, utilisée quand aucun résolveur n'est configuré. Ne codez pas ce domaine en dur, lisez la valeur renvoyée.

#Les champs de la réponse

#Le bloc warranty

#Le bloc evidence

Trois valeurs existent, et elles sont calculées par SealTrust. Une marque ne peut pas les choisir.

Quatre sections peuvent porter une de ces valeurs : identity, integrity, composition et substances_of_concern. Seules les sections que le passeport contient réellement en reçoivent une.

identity et integrity sont toujours présentes, parce qu'elles portent sur l'exemplaire lui-même. La section identity passe à verified quand l'unité porte un identifiant de jeton sur la chaîne. La section integrity passe à verified quand l'empreinte de cette version a été ancrée et correspond toujours aux données enregistrées.

composition et substances_of_concern n'apparaissent que si les données du passeport les portent. Un passeport qui ne décrit aucune matière ne reçoit aucune mention de composition, et sections compte alors deux entrées. Un bloc de matières resté vide (lignes sans nom, sans part et sans origine) ne décrit aucune matière. Le nombre d'entrées va donc de deux à quatre selon le passeport servi.

Le bloc porte en plus legend, qui redit le sens des valeurs présentes, derived à true, et note.

N'affichez une mention que pour les sections que sections nomme. Une section absente n'est ni vérifiée ni infirmée, elle n'est simplement pas notée.

#Le bloc lifecycle

Il n'apparaît que si l'unité est détruite ou sortie du catalogue. Son passeport reste servi pour que l'identifiant continue de résoudre.

{
  "lifecycle": {
    "status": "superseded",
    "is_burned": false,
    "superseded": true,
    "note": "This unit is superseded or withdrawn; its passport is retained so the identifier stays resolvable (EN 18219 §4.2.2 persistence)."
  }
}

Lisez is_burned avant status.

Le champ status vaut superseded quand l'unité a été remplacée par une autre, et archived quand elle a été retirée sans remplacement. Le champ superseded ne vaut true que pour le premier cas.

Le bloc apparaît aussi quand l'unité a été détruite, c'est-à-dire quand is_burned vaut true. Dans ce cas status porte l'état courant du produit, qui peut être null ou une valeur active. Ne déduisez donc jamais la destruction de la valeur de status.

#Le bloc integrity

{
  "integrity": {
    "ipfs_fetched": true,
    "ipfs_hash": "1111111111111111111111111111111111111111111111111111111111111111",
    "expected_hash": "1111111111111111111111111111111111111111111111111111111111111111",
    "match": true
  }
}

expected_hash est l'empreinte de la projection PUBLIQUE du passeport, celle qui est déposée sur IPFS. Elle diffère de data_hash, qui couvre les données complètes, y compris les champs réservés aux niveaux professionnels. Les deux valeurs coïncident seulement quand le passeport ne porte aucun champ non public. Ne comparez donc jamais expected_hash et data_hash.

Le champ match vaut true quand la copie IPFS correspond, false quand elle diffère, et null quand la copie n'a pas pu être récupérée. Dans ce dernier cas ipfs_fetched vaut false, un champ error remplace les deux empreintes, et null signifie que rien n'a pu être conclu.

#La réponse en JSON-LD

Avec format=jsonld, la réponse porte le type de contenu application/ld+json. C'est un document Schema.org et GS1 dont les champs sont filtrés par le même niveau d'accès. Il ne contient ni passport_version, ni data_hash, ni les blocs warranty, evidence, lifecycle et integrity décrits ci-dessus : la garantie y est exprimée en WarrantyPromise, et les autres blocs n'y figurent pas. Le prestataire de la copie de sauvegarde y figure sous espr:passportServiceProvider (identifier, name, espr:backedUpAt), dans les mêmes conditions que passport_service_provider, et il est absent tant que la copie n'existe pas.

Deux autres différences comptent pour votre intégration.

Le document ne porte pas de champ access_tier. Le serveur ne renvoie pas non plus l'en-tête X-DPP-Access-Tier. Pour connaître le niveau réellement servi, appelez sans format, ou tenez-vous-en au niveau que vous avez demandé.

Le serveur ignore verify_integrity dans ce format. Il rend le document JSON-LD avant de calculer le bloc integrity, donc ce paramètre ne change rien à la réponse et aucune erreur ne vous le signale.