Добавить ссылки

Подключает к объекту новые площадки. Тело запроса – массив ссылок, без объекта-обёртки, до 200 за раз.

Примеры адресов ссылок и где их взять – в Форматах ссылок.

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

На одну площадку в объекте приходится одна ссылка.

Параметры

object_idчислообязательный

Объект, в который добавляются ссылки.

Idempotency-Keyстрока

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

Тело запроса

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

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

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

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

[].link_nameстрока

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

Ответ

object_idчисло

Объект, в который добавлялись ссылки.

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. Пусто при успехе.

curl -X POST "https://example.com/v3/objects/0/links" \  -H "Content-Type: application/json" \  -d '[    {      "url": "https://2gis.ru/moscow/firm/70000001006369779",      "link_name": "2ГИС"    },    {      "url": "https://www.tripadvisor.ru/Hotel_Review-g298484-d299118",      "link_name": "Tripadvisor"    }  ]'

{  "object_id": 20,  "link_results": [    {      "url": "https://2gis.ru/moscow/firm/70000001006369779",      "link_id": 523,      "source_slug": "2gis",      "link_name": "2ГИС",      "error": null    },    {      "url": "https://www.tripadvisor.ru/Hotel_Review-g298484-d299118",      "link_id": null,      "source_slug": null,      "link_name": "Tripadvisor",      "error": "Площадка по этому адресу не поддерживается"    }  ]}

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