发布你的产品

方式 1

在自己的域名上发布

两个文件加一条 DNS 记录。代表商户发布的平台在每个商户域名上做同样的事，因此每个商户都保有自己的身份和可信度等级。

1. 1

   提供发现文档

   一个位于固定路径的文件，列出你的产品 feed 在哪里：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

   提供 feed

   feed 是 NDJSON：每行一个完整的 JSON 对象，UTF-8，以换行分隔。外面不包数组，行与行之间没有逗号。这样，两百万件产品的 feed 也能逐行流式读取，一行出错只损失那一行，不影响其余部分。

   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 中认领身份

   文件上线后，发布一条把你自己的域名作为主机的记录。

   _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

委托托管，保留身份

很多制造商拥有域名，却无法在上面放文件。feed 托管在别处，域名用 DNS 证明，所以来源身份仍然是域名，可信度仍然是 verified。在 publish.prodid.org 创建站点并输入你的域名，它会显示需要添加的确切记录，并替你检查。

具体是什么样

1. 1

   上传到托管 slug 的目录

   ，例如 acme.prodid.org，它同时提供发现文档和 feed。

   将此步骤标为已完成
2. 2

   你所拥有域名上的一条 TXT 记录

   ，指向那台主机。是主机而不是 URL，因此记录永远无法把抓取程序引向任意地址。

   _prodid.acme.example TXT

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

   将此步骤标为已完成
3. 3

   一份回指你域名的文档。

   DNS 说“我的文档在那边”；文档说“我代表那个域名”。没有 domain 的委托文档会被拒绝：缺失永远不会被当作同意，正是这一点阻止了任何人把记录指向别人的 feed。

   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 申请一个。来源身份是 slug 主机，可信度是 unverified，因为没有证明任何关于域名的事情。这些记录是真正的记录：标识符、解析、来源归属一应俱全。

   从 publish.prodid.org 开始 →
   详情与字段参考
   将此步骤标为已完成