---
title: "Добавить ссылки"
method: POST
path: "/v3/objects/{object_id}/links"
tags: ["links"]
---

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

`POST /v3/objects/{object_id}/links`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/objects/{object_id}/links`
- Auth: API key in header `X-API-Key`

Добавить ссылки в объект — до 200 за раз.

Площадка определяется по домену URL. Ответ содержит итог по каждой ссылке
отдельно: успех с `link_id` или `error` — часть ссылок может не добавиться,
остальные при этом добавляются. Сбор по новым ссылкам стартует сразу.

## Path parameters

- `object_id` integer, required: Идентификатор объекта

## Headers

- `Idempotency-Key` string, nullable

## Request body

- LinkInputV3[]
  - `url` string, uri, required: Адрес страницы объекта на площадке. Площадка определяется по домену.
  - `is_active` boolean: Собирать ли отзывы по этой ссылке.
  - `link_name` string, nullable: Своё название ссылки внутри объекта.

## Response `201`

Successful Response

- BulkLinksResponseV3: Итог массового добавления ссылок в объект.
  - `object_id` integer, required: Объект, в который добавлялись ссылки.
  - `link_results` LinkResultV3[], required: Итог по каждой переданной ссылке.
    - `url` string, required: URL ссылки, к которой относится результат.
    - `link_id` integer, nullable: Идентификатор созданной ссылки. `null` при ошибке.
    - `source_slug` string, nullable: Машинное имя площадки, определённой по URL (`2gis`, `yandex_travel`). `null`, если определить не удалось.
    - `link_name` string, nullable: Название ссылки, как оно сохранено.
    - `error` string, nullable: Причина, по которой ссылка не добавлена. `null` при успехе.
    - `error_code` string, nullable: Машинная причина отказа — по ней и следует ветвиться: `source_not_detected`, `source_url_invalid`, `source_requires_upgrade`, `source_already_linked` (площадка в объекте может быть только одна), `link_already_added`. `null` при успехе.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/rewio/apis/review-aggregator.md) · [All operations](https://skmtc.dev/rewio/apis/review-aggregator/llms.txt) · [OpenAPI document](https://skmtc.dev/rewio/apis/review-aggregator/revisions/9222b6cf28a5?raw)