---
title: "Создать объект"
method: POST
path: "/v3/objects"
tags: ["objects"]
---

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

`POST /v3/objects`

## Request

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

Создать объект — единицу бизнеса, по которой вы получаете отзывы,
аналитику и (опционально) вебхуки.

Объект — основная единица адресации в API: `GET /v3/reviews`,
`GET /v3/analytics` и подписки `POST /v3/webhooks` работают через
`object_id`. Внутри объекта — ссылки: по одной на каждую площадку (Яндекс
Карты, Google, 2ГИС, Островок и т.д.), которые сервис сам периодически
опрашивает.

Ссылки можно передать сразу (`links`, до 200 штук) или не передавать —
объект создастся пустым, ссылки добавляются позже через
`POST /v3/objects/{object_id}/links`. Площадка определяется по домену URL.

Объект занимает место в тарифе с момента создания — при исчерпании лимита
ответ `403`. `link_results` показывает итог по каждой ссылке отдельно:
часть ссылок может не добавиться, но сам объект при этом создаётся.

## Headers

- `Idempotency-Key` string, nullable

## Request body

- ObjectCreateV3: Тело создания объекта.
  - `name` string, required: Название объекта.
  - `links` LinkInputV3[], nullable: Ссылки, которые добавить сразу (до 200). Можно не передавать — объект создастся пустым, ссылки добавляются позже через `POST /v3/objects/{object_id}/links`.
    - `url` string, uri, required: Адрес страницы объекта на площадке. Площадка определяется по домену.
    - `is_active` boolean: Собирать ли отзывы по этой ссылке.
    - `link_name` string, nullable: Своё название ссылки внутри объекта.

## Response `201`

Successful Response

- ObjectCreateResponseV3: Созданный объект и результат по каждой переданной ссылке.
  - `id` integer, required: Идентификатор созданного объекта.
  - `name` string, required: Название объекта.
  - `created_at` string, date-time, required: Момент создания объекта (UTC, ISO 8601).
  - `link_results` LinkResultV3[], nullable: Итог по каждой переданной ссылке. `null`, если ссылок не было.
    - `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)