Опубликовать товары

Путь 1

Публикация на своём домене

Два файла и одна DNS-запись. Платформа, публикующая от имени магазинов, делает то же самое на домене каждого магазина, поэтому каждый сохраняет свою идентичность и свой уровень доверия.

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: один полный JSON-объект на строку, UTF-8, строки разделены переводом строки. Без массива вокруг и без запятых между строками. Так фид на два миллиона товаров читается построчно, а одна плохая строка стоит вам только этой строки, а не остальных.

   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

   Сообщите индексу об изменении

   Необязательно. Каждый известный домен обходится заново по расписанию, а пинг лишь приближает следующий обход.

   попросить индекс запустить обнаружение сейчас

   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

Делегируйте хостинг, сохраните идентичность

Многие производители владеют доменом, но не могут положить на него файл. Фид размещается в другом месте, а домен подтверждается через DNS, поэтому идентичность источника по-прежнему домен, а уровень доверия по-прежнему 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

   Создайте свой сайт

   Хостинг-публикатор записывает domain в документ только после того, как сам увидит вашу запись TXT, поэтому нет момента, когда документ претендует на домен, который об этом не просил.

   Начать на publish.prodid.org →
   Отметить шаг выполненным

Путь 3

Публикация без домена

1. 1

   Создайте свой сайт

   Производитель без домена публикует на slug на хостинге, <slug>.prodid.org, под своим именем. Зарезервируйте его на publish.prodid.org. Идентичность источника — хост slug, уровень доверия — unverified, потому что про домен ничего не доказано. Записи — настоящие записи: идентификаторы, разрешение, атрибуция.

   Начать на publish.prodid.org →
   Подробности и справочник по полям
   Отметить шаг выполненным