Создать объект

Объект – ваш объект: отель, клиника, филиал, врач или специалист. Ссылки на площадки передаются при создании или отдельным методом добавления ссылок.

Ссылка, которую не удалось добавить, не отменяет остальные: они добавятся, а по ней в link_results придёт причина отказа.

Какой адрес принимает каждая площадка, смотрите в Форматах ссылок.

Параметры

Idempotency-Keyстрока

Свой ключ запроса. Повтор с тем же ключом вернёт первый объект, а не создаст второй.

Тело запроса

nameстрокаобязательный

Название объекта. Его видно в личном кабинете и в ответах API.

linksсписок объектов

Ссылки на страницы объекта на площадках. Можно не передавать и добавить позже.

links[].urlссылкаобязательный

Адрес страницы объекта на площадке, как он открывается в браузере. Площадку определим сами.

links[].is_activeда/нетпо умолчанию да

Собирать ли отзывы по этой ссылке.

links[].link_nameстрока

Своё название ссылки внутри объекта, например «Филиал на Невском».

Ответ

idчисло

Идентификатор созданного объекта.

nameстрока

Название объекта.

created_atдата и время

Когда объект создан.

link_resultsсписок объектовможет быть пустым

Итог по каждой переданной ссылке, в том же порядке.

link_results[].urlстрока

Адрес, к которому относится результат.

link_results[].link_idчисломожет быть пустым

Идентификатор созданной ссылки. Пусто, если ссылку добавить не удалось.

link_results[].source_slugстрокаможет быть пустым

Площадка, определённая по адресу.

link_results[].link_nameстрокаможет быть пустым

Своё название ссылки, если его задавали.

link_results[].errorстрокаможет быть пустым

Причина, по которой ссылку не удалось добавить.

link_results[].error_codeстрокаможет быть пустым

Машинная причина отказа — по ней и следует ветвиться: source_not_detected, source_url_invalid, source_requires_upgrade, source_already_linked (площадка в объекте может быть только одна), link_already_added. null при успехе.

curl -X POST "https://example.com/v3/objects" \  -H "Content-Type: application/json" \  -d '{    "name": "Гостиница «Националь»",    "links": [      {        "url": "https://yandex.com/maps/org/national/1020542995",        "link_name": "Яндекс Карты"      },      {        "url": "https://ostrovok.ru/hotel/russia/moscow/mid7467340/gostinitsa_natsional_moskva",        "link_name": "Островок"      }    ]  }'

{  "name": "Гостиница «Националь»",  "id": 218,  "created_at": "2026-08-03T13:41:08",  "link_results": [    {      "url": "https://yandex.com/maps/org/national/1020542995",      "link_id": 521,      "source_slug": "yandex_maps",      "link_name": "Яндекс Карты",      "error": null    },    {      "url": "https://ostrovok.ru/hotel/russia/moscow/mid7467340/gostinitsa_natsional_moskva",      "link_id": 522,      "source_slug": "ostrovok",      "link_name": "Островок",      "error": null    }  ]}

Коды ошибок общие для всего API и описаны на странице Ошибки.