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

Подключает к объекту новые площадки.

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

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

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

Параметры

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

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

Idempotency-Keyстрока

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

Ответ

group_idчисло

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

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

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

link_results[].urlстрока

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

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

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

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

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

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

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

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

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

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

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

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