Produkte veröffentlichen

Weg 1

Auf der eigenen Domain veröffentlichen

Zwei Dateien und ein DNS-Eintrag. Eine Plattform, die für Händler veröffentlicht, tut dasselbe auf jeder Händlerdomain, sodass jeder Händler seine eigene Identität und seine eigene Vertrauensstufe behält.

1. 1

   Das Discovery-Dokument ausliefern

   Eine Datei unter einem festen Pfad, die auflistet, wo Ihre Produkt-Feeds liegen: 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"]
   }

   Details und Feldreferenz
   Diesen Schritt als erledigt markieren
2. 2

   Den Feed ausliefern

   Ein Feed ist NDJSON: ein vollständiges JSON-Objekt pro Zeile, UTF-8, durch Zeilenumbrüche getrennt. Kein Array drumherum, keine Kommas zwischen den Zeilen. So lässt sich ein Feed mit zwei Millionen Produkten Zeile für Zeile streamen, und eine kaputte Zeile kostet Sie nur diese Zeile, nicht den Rest.

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

   Details und Feldreferenz
   Diesen Schritt als erledigt markieren
3. 3

   Die Identität im DNS beanspruchen

   Sobald die Dateien online sind, veröffentlichen Sie einen Eintrag, der Ihre eigene Domain als Host nennt.

   _prodid.acme.example TXT

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

   Details und Feldreferenz
   Diesen Schritt als erledigt markieren
4. 4

   Dem Index die Änderung melden

   Optional. Jede bekannte Domain wird regelmäßig neu gecrawlt; ein Ping zieht nur den nächsten Crawl vor.

   den Index bitten, die Discovery jetzt auszuführen

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

   Details und Feldreferenz
   Diesen Schritt als erledigt markieren

Weg 2

Hosting delegieren, Identität behalten

Viele Hersteller besitzen eine Domain und können keine Datei darauf legen. Der Feed wird anderswo gehostet und die Domain per DNS nachgewiesen, sodass die Identität der Quelle weiter die Domain ist und die Vertrauensstufe weiter verified. Legen Sie bei publish.prodid.org eine Site an, geben Sie Ihre Domain ein, und Sie sehen genau den Eintrag, den Sie hinzufügen müssen; geprüft wird er für Sie.

So sieht es aus

1. 1

   Ein Katalog, hochgeladen unter einem gehosteten Slug

   , etwa acme.prodid.org, der sowohl das Discovery-Dokument als auch den Feed ausliefert.

   Diesen Schritt als erledigt markieren
2. 2

   Ein TXT-Eintrag auf Ihrer Domain

   , der diesen Host nennt. Ein Host, nie eine URL, sodass ein Eintrag den Crawler nie auf eine beliebige Adresse richten kann.

   _prodid.acme.example TXT

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

   Diesen Schritt als erledigt markieren
3. 3

   Ein Dokument, das Ihre Domain zurück nennt.

   DNS sagt mein Dokument liegt dort drüben; das Dokument sagt ich spreche für diese Domain. Ein delegiertes Dokument ohne domain wird abgelehnt: Fehlen gilt nie als Zustimmung, und genau das verhindert, dass jemand einen Eintrag auf den Feed eines anderen richtet.

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

   Diesen Schritt als erledigt markieren
4. 4

   Legen Sie Ihre Seite an

   Der gehostete Publisher schreibt domain erst ins Dokument, nachdem er Ihren TXT-Eintrag selbst gesehen hat; es gibt also keinen Moment, in dem ein Dokument eine Domain beansprucht, die nicht darum gebeten hat.

   Bei publish.prodid.org starten →
   Diesen Schritt als erledigt markieren

Weg 3

Ohne Domain veröffentlichen

1. 1

   Legen Sie Ihre Seite an

   Ein Erzeuger ganz ohne Domain veröffentlicht unter einem gehosteten Slug, <slug>.prodid.org, unter eigenem Namen. Sichern Sie sich einen bei publish.prodid.org. Die Identität der Quelle ist der Slug-Host und die Vertrauensstufe unverified, weil über eine Domain nichts nachgewiesen ist. Die Datensätze sind echte Datensätze: Kennungen, Auflösung, Zuschreibung.

   Bei publish.prodid.org starten →
   Details und Feldreferenz
   Diesen Schritt als erledigt markieren