objects

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

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

Объект — основная единица адресации в 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 показывает итог по каждой ссылке отдельно: часть ссылок может не добавиться, но сам объект при этом создаётся.

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

Headers

Idempotency-Keystring nullable

Request body

namestring required

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

Example request

{
  "links": [
    {
      "url": "https://yandex.ru/maps/org/natsional/1049256789/"
    }
  ],
  "name": "Отель Националь"
}

Response

Successful Response

idinteger required

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

namestring required

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

created_atstring date-time required

Момент создания объекта (UTC, ISO 8601).

Changes

No recorded changes to this operation across all 1 revision of this API.