製品を公開する

方法 1

自分のドメインで公開する

2 つのファイルと 1 つの DNS レコード。加盟店に代わって公開するプラットフォームは、加盟店ドメインごとに同じことを行うので、各加盟店が自分の ID と信頼レベルを保ちます。

1. 1

   ディスカバリー文書を配信する

   製品フィードの場所を列挙する、固定パスの 1 つのファイル: 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"]
   }

   詳細とフィールドリファレンス
   このステップを完了にする
2. 2

   フィードを配信する

   フィードは NDJSON です。1 行に 1 つの完全な JSON オブジェクト、UTF-8、改行区切り。外側に配列はなく、行の間にカンマもありません。こうすることで 200 万製品のフィードも 1 行ずつストリーム処理でき、壊れた行は残りではなくその行だけを失います。

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

   詳細とフィールドリファレンス
   このステップを完了にする
3. 3

   DNS で ID を確保する

   ファイルが公開されたら、自分のドメインをホストとするレコードを公開します。

   _prodid.acme.example TXT

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

   詳細とフィールドリファレンス
   このステップを完了にする
4. 4

   変更をインデックスに知らせる

   任意です。既知のドメインはすべて定期的に再取得され、ping は次の取得を早めるだけです。

   インデックスに今すぐディスカバリーを実行するよう依頼する

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

   詳細とフィールドリファレンス
   このステップを完了にする

方法 2

ホスティングを委任し、ID は保つ

ドメインは持っていても、そこにファイルを置けないメーカーは多くあります。フィードは別の場所にホストされ、ドメインは DNS で証明されるので、ソースの ID はドメインのまま、信頼は verified のままです。publish.prodid.org でサイトを作ってドメインを入力すると、追加すべき正確なレコードが表示され、確認もしてくれます。

実際の形

1. 1

   ホスト型 slug のディレクトリにアップロード

   します。例えば acme.prodid.org で、ディスカバリー文書とフィードの両方を配信します。

   このステップを完了にする
2. 2

   自分が所有するドメインの TXT レコード

   で、そのホストを指します。URL ではなくホストなので、レコードがクローラーを任意のアドレスに向けることはできません。

   _prodid.acme.example TXT

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

   このステップを完了にする
3. 3

   あなたのドメインを指し返す文書。

   DNS は「私の文書はあそこにある」と言い、文書は「私はそのドメインを代表している」と言います。domain のない委任文書は拒否されます。欠落が同意とみなされることは決してなく、それこそが他人のフィードにレコードを向けることを防いでいます。

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

   このステップを完了にする
4. 4

   サイトを作成する

   ホスト型パブリッシャーは、あなたの TXT レコードを自分で確認してから初めて domain を文書に書き込むので、求めていないドメインを文書が主張する時間帯は存在しません。

   publish.prodid.org で始める →
   このステップを完了にする

方法 3

ドメインなしで公開する

1. 1

   サイトを作成する

   ドメインをまったく持たない生産者は、ホスト型 slug <slug>.prodid.org で自分の名前で公開します。publish.prodid.org で申し込んでください。ソースの ID は slug ホストで、ドメインについて何も証明されていないため信頼は unverified です。レコードは本物のレコードで、識別子も解決も出典の帰属もすべてそろっています。

   publish.prodid.org で始める →
   詳細とフィールドリファレンス
   このステップを完了にする