rewio-ru Sources API

openapi: 3.2.0
info:
  title: Review Aggregator Sources API
  description: 'Единый REST API для отзывов: сервис собирает отзывы с площадок (Яндекс Карты, 2ГИС, Google, Островок, ДокДок и др.), приводит их к общей модели и отдаёт с фильтрами и аналитикой.


    📚 **Гайды, quickstart и полный справочник – на портале разработчика: https://docs.rewio.ru**


    #### Как начать

    1. Создайте **объект** – единицу бизнеса, отзывы по которой собираем.

    2. Добавьте в него **ссылки** на страницы объекта на нужных площадках.

    3. Запрашивайте **отзывы** и **аналитику** – данные обновляются дважды в сутки.


    #### Что вы получаете по каждому отзыву

    - **Текст**, **автор**, **оценка** – приведена к единой шкале 1–5 независимо от площадки

    - **Ответ организации** – текст и дата

    - **Изображения и видео** – превью и полноразмерные ссылки


    #### Работа с отзывами

    На тарифе «Полный»:

    - **Ответы** – публикация, замена и удаление ответа от лица организации (на пробном доступе – 3 на площадку)

    - **Жалобы** – подача жалобы на отзыв через форму площадки и её итог (на пробном доступе – 3 на площадку)

    - **Дополнительный сбор** – новые отзывы по объекту вне расписания, раз в сутки (на пробном доступе – 5 сборов)


    #### Соглашения

    - **Базовый URL:** `https://api.rewio.ru`. Актуальная версия – `/v3`.

    - **Авторизация:** заголовок `X-API-Key: ` в каждом запросе. Области ключа: `read_only` / `full`.

    - **Формат:** JSON на вход и выход.

    - **Даты:** UTC, ISO 8601 без таймзоны (`2026-02-25T09:28:07`). Время площадки (`review_date`, `reply_date`) приводится к UTC везде, где это возможно; в противном случае – как на площадке.

    - **Оценки:** нормализованы к единой шкале 1–5 независимо от площадки; исходное значение площадки сохраняется отдельно (`rating_original`).

    - **Списки:** ключ элементов всегда `data`. Постраничные ответы – `{data, total, limit, offset, has_next}` (параметры `limit` 1–1000 и `offset`); полные списки – только `{data}`.

    - **Ошибки:** единый формат `{"detail": "...", "code": "..."}` с машиночитаемым `code`. Отдельно стоит `402`: доступ приостановлен (закончился пробный период или оплата) либо площадка не входит в тариф – повтор запроса не поможет.

    - **Ограничение частоты:** при слишком частых запросах – `429`; повторите с задержкой.


    #### Проба

    В блоке авторизации уже подставлен тестовый ключ (только чтение) – можно сразу выполнить любой GET-запрос.


    **Тестовый ключ (только чтение):** `hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M`

    **Тестовый объект:** Отель Националь, **object_id = 20**


    Бесплатный тестовый доступ на создание 30 объектов.

    **Подключение и доступ:** 📧 info@rewio.ru · ✈️ @const_rewio'
  version: 3.0.0
servers:
- url: https://api.rewio.ru
  description: Production
tags:
- name: Sources
  description: Список поддерживаемых площадок отзывов.
paths:
  /v3/sources:
    get:
      tags:
      - Sources
      summary: Список площадок
      description: 'Список площадок, с которых Rewio собирает отзывы – Яндекс Карты,

        Google, 2ГИС и ещё почти три десятка сервисов.


        Отсюда берут `id` площадки, чтобы

        использовать его в фильтрах у отзывов и аналитики. `supports_replies`

        говорит, бывают ли на площадке ответы организации вообще, а

        `can_publish_reply` – умеем ли мы их там публиковать за вас,

        `can_file_complaint` – подавать жалобы на отзывы.'
      operationId: list_sources_v3_v3_sources_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReturnAll_SourceV3_'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - APIKeyHeader: []
components:
  schemas:
    ReturnAll_SourceV3_:
      properties:
        data:
          items:
            $ref: '#/components/schemas/SourceV3'
          type: array
          title: Data
          description: Все элементы (пагинации нет).
      type: object
      required:
      - data
      title: ReturnAll[SourceV3]
    SourceV3:
      properties:
        id:
          type: integer
          title: Id
          description: Идентификатор площадки. Им фильтруются отзывы и аналитика (`source_ids`).
        slug:
          type: string
          title: Slug
          description: 'Машинное имя площадки, стабильное: `yandex_travel`, `google`, `2gis`.'
        name:
          type: string
          title: Name
          description: 'Название площадки для показа человеку: `YandexTravel`.'
        base_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Url
          description: Базовый адрес площадки. Ссылки объекта должны вести на этот домен.
        rating_scale:
          anyOf:
          - type: integer
          - type: 'null'
          title: Rating Scale
          description: Исходная шкала оценок площадки (например, 5 или 10). Оценки в `/reviews` уже нормализованы к шкале 1–5 (`rating`); исходное значение – в `rating_original`. `null`, если площадка не выставляет оценок.
        supports_replies:
          type: boolean
          title: Supports Replies
          description: Площадка поддерживает публичные ответы организации на отзывы.
        supports_images:
          type: boolean
          title: Supports Images
          description: Отзывы на площадке могут содержать изображения.
        providers:
          items:
            type: string
          type: array
          title: Providers
          description: Площадки-источники, чьи отзывы встречаются в ленте этой площадки (слаги в нижнем регистре, у отзыва – в поле `provider`). У большинства это только сам слаг; 2ГИС показывает ещё `booking`/`tbank`/`flamp`/…, Google – `tripadvisor`. Отвечать можно только на отзывы, чей `provider` равен слагу этой площадки.
        can_publish_reply:
          type: boolean
          title: Can Publish Reply
          description: 'Rewio умеет публиковать ответы на этой площадке. Отличается от `supports_replies`: тот про саму площадку, этот – про то, что ответ можете опубликовать вы, через нас.'
        can_file_complaint:
          type: boolean
          title: Can File Complaint
          description: Rewio умеет подавать на этой площадке жалобы на отзывы (`/v3/reviews/{review_id}/complaints`).
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Момент добавления площадки в сервис (UTC, ISO 8601).
      type: object
      required:
      - id
      - slug
      - name
      - supports_replies
      - supports_images
      - can_publish_reply
      - created_at
      title: SourceV3
      description: Площадка отзывов (/v3).
      example:
        base_url: https://travel.yandex.ru
        can_file_complaint: false
        can_publish_reply: false
        created_at: '2026-02-08T18:33:17'
        id: 3
        name: YandexTravel
        rating_scale: 5
        slug: yandex_travel
        supports_images: true
        supports_replies: true
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
        code:
          type: string
          title: Code
      type: object
      required:
      - detail
      - code
      title: ErrorResponse
      description: Standard error response returned by all exception handlers.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    APIKeyCookie:
      type: apiKey
      in: cookie
      name: rewio_session