Publier vos produits

Voie 1

Publier sur votre propre domaine

Deux fichiers et un enregistrement DNS. Une plateforme qui publie pour des marchands fait la même chose sur chaque domaine marchand, si bien que chacun garde sa propre identité et son propre niveau de confiance.

1. 1

   Servir le document de découverte

   Un fichier, à un chemin fixe, qui indique où sont vos flux produit : https://acme.example/.well-known/prodid.json

   .well-known/prodid.jsonapplication/json

   {
   	"$type": "org.prodid.feed",
   	"version": 1,
   	"publisher": { "name": "Acme Tekstil", "contact": "data@acme.example" },
   	"license": "CC0-1.0",
   	"feeds": ["https://acme.example/prodid/items.ndjson"]
   }

   Détails et référence des champs
   Marquer cette étape comme faite
2. 2

   Servir le flux

   Un flux est du NDJSON : un objet JSON complet par ligne, UTF-8, séparé par des retours à la ligne. Pas de tableau autour, pas de virgules entre les lignes. Ainsi un flux de deux millions de produits se lit ligne à ligne, et une ligne défectueuse ne vous coûte que cette ligne, pas le reste.

   prodid/items.ndjsonapplication/x-ndjson

   {"$type":"org.prodid.item","key":"TJ-2041-NVY-M","brand":"Acme","name":"Trail Jacket","lang":"en","group":"TJ-2041","variant":{"color":"navy","size":"M"},"identifiers":[{"scheme":"gtin","value":"09506000134352"},{"scheme":"mpn","value":"TJ-2041-NVY-M"}],"markets":["TR","DE"],"properties":{"material":"100% recycled polyester","madeIn":"TR","weight":{"value":480,"unit":"g"}},"media":[{"url":"https://acme.example/img/tj2041-navy.webp","license":"CC-BY-4.0","kind":"image"}]}
   {"$type":"org.prodid.item","key":"TJ-2041-NVY-L","brand":"Acme","name":"Trail Jacket","lang":"en","group":"TJ-2041","variant":{"color":"navy","size":"L"},"identifiers":[{"scheme":"gtin","value":"09506000134406"},{"scheme":"mpn","value":"TJ-2041-NVY-L"}],"markets":["TR","DE"],"properties":{"material":"100% recycled polyester","madeIn":"TR","weight":{"value":505,"unit":"g"}},"media":[{"url":"https://acme.example/img/tj2041-navy.webp","license":"CC-BY-4.0","kind":"image"}]}
   {"$type":"org.prodid.item","key":"TJ-2041-OLV-M","brand":"Acme","name":"Trail Jacket","lang":"en","group":"TJ-2041","variant":{"color":"olive","size":"M"},"identifiers":[{"scheme":"gtin","value":"09506000134413"},{"scheme":"mpn","value":"TJ-2041-OLV-M"}],"markets":["TR"],"properties":{"material":"100% recycled polyester","madeIn":"TR","weight":{"value":480,"unit":"g"}},"media":[{"url":"https://acme.example/img/tj2041-olive.webp","license":"CC-BY-4.0","kind":"image"}]}

   Détails et référence des champs
   Marquer cette étape comme faite
3. 3

   Revendiquer l’identité dans le DNS

   Une fois les fichiers en ligne, publiez un enregistrement qui nomme votre propre domaine comme hôte.

   _prodid.acme.example TXT

   _prodid.acme.example. IN TXT "v=prodid0; host=acme.example"

   Détails et référence des champs
   Marquer cette étape comme faite
4. 4

   Signaler le changement à l’index

   Facultatif. Chaque domaine connu est réexploré selon un calendrier ; un ping ne fait qu’avancer la prochaine exploration.

   demander à l’index de lancer la découverte maintenant

   curl -X POST https://prodid.org/ping \
     -H 'content-type: application/json' \
     -d '{"domain": "acme.example"}'
   
   HTTP/1.1 202 Accepted
   Content-Type: application/json
   
   {"status":"accepted"}

   Détails et référence des champs
   Marquer cette étape comme faite

Voie 2

Déléguer l’hébergement, garder l’identité

Beaucoup de fabricants possèdent un domaine sans pouvoir y déposer de fichier. Le flux est hébergé ailleurs et le domaine prouvé par le DNS : l’identité de la source reste le domaine et le niveau de confiance reste verified. Créez un site sur publish.prodid.org, saisissez votre domaine ; il affiche l’enregistrement exact à ajouter et le vérifie pour vous.

À quoi cela ressemble

1. 1

   Un catalogue téléversé sur un slug hébergé

   , par exemple acme.prodid.org, qui sert à la fois le document de découverte et le flux.

   Marquer cette étape comme faite
2. 2

   Un enregistrement TXT sur le domaine que vous possédez

   , qui nomme cet hôte. Un hôte, jamais une URL : un enregistrement ne peut donc jamais diriger le robot vers une adresse arbitraire.

   _prodid.acme.example TXT

   _prodid.acme.example. IN TXT "v=prodid0; host=acme.prodid.org"

   Marquer cette étape comme faite
3. 3

   Un document qui nomme votre domaine en retour.

   Le DNS dit mon document est là-bas ; le document dit je parle pour ce domaine. Un document délégué sans domain est rejeté : l’absence ne vaut jamais consentement, et c’est ce qui empêche quiconque de pointer un enregistrement vers le flux de quelqu’un d’autre.

   acme.prodid.org/.well-known/prodid.jsonapplication/json

   {
   	"$type": "org.prodid.feed",
   	"version": 1,
   	"domain": "acme.example",
   	"publisher": { "name": "Acme Tekstil", "contact": "data@acme.example" },
   	"license": "CC0-1.0",
   	"feeds": ["https://acme.prodid.org/feeds/items.ndjson"]
   }

   Marquer cette étape comme faite
4. 4

   Créez votre site

   L’éditeur hébergé n’écrit domain dans le document qu’après avoir vu lui-même votre enregistrement TXT : il n’y a donc aucun moment où un document revendique un domaine qui ne l’a pas demandé.

   Commencer sur publish.prodid.org →
   Marquer cette étape comme faite

Voie 3

Publier sans domaine

1. 1

   Créez votre site

   Un producteur sans aucun domaine publie sur un slug hébergé, <slug>.prodid.org, sous son propre nom. Réservez-en un sur publish.prodid.org. L’identité de la source est l’hôte du slug et le niveau de confiance unverified, car rien n’a été prouvé sur un domaine. Les enregistrements sont de vrais enregistrements : identifiants, résolution, attribution.

   Commencer sur publish.prodid.org →
   Détails et référence des champs
   Marquer cette étape comme faite