Войти

API Документация

Подключайте MyReviews к своим приложениям и автоматизируйте работу с компаниями, площадками, отзывами, тегами и ответами через REST API.

Base URL https://myreviews.dev/v1 Авторизация Bearer JWT

Введение

Обзор API

REST API MyReviews позволяет программно управлять организациями, площадками отзывов, самими отзывами, тегами и ответами. API подходит для интеграции с CRM, дашбордами аналитики, чат-ботами и любыми другими системами.

Base URL

Все запросы выполняются к единому адресу:

https://myreviews.dev/v1

Протокол и формат

  • Только HTTPS
  • Тело запросов – application/json
  • Все ответы – JSON
  • Кодировка – UTF-8

Аутентификация

API использует JWT-токены (JSON Web Tokens). Большинство методов требуют авторизации – исключения отмечены как «публичные».

  1. Отправьте POST /v1/user/login с email и паролем.
  2. В ответе получите поле data.jwt – это ваш токен.
  3. Передавайте токен в заголовке каждого защищённого запроса:
    Authorization: Bearer <jwt>

⚠️ Безопасность

Храните JWT в защищённом месте. Не передавайте токен через URL-параметры и не встраивайте в клиентский JavaScript, доступный пользователям. Если токен скомпрометирован – смените пароль, чтобы выпустить новый.

Формат ответов

Каждый ответ содержит три поля:

{
  "status": 200,
  "message": "Описание результата.",
  "data": { }
}
ПолеТипОписание
statusintegerHTTP-код ответа (дублируется для удобства парсинга)
messagestringЧеловекочитаемое описание результата на русском языке
dataobject | array | string | nullПолезная нагрузка: объект, массив, строка или null при ошибке

Коды ошибок

API использует стандартные HTTP-коды. В теле ответа всегда присутствует message с деталями.

КодЗначениеКогда возникает
200УспехЗапрос выполнен
400Ошибка валидацииНеверные или отсутствующие параметры
401Не авторизованОтсутствует или невалидный JWT-токен
403Доступ запрещёнНет прав на запрашиваемый ресурс (например, чужая компания)
404Не найденоРесурс с указанным ID не существует
429Too Many RequestsПревышен лимит запросов – подождите и повторите

Пагинация

Методы, возвращающие списки (компании, отзывы), поддерживают пагинацию. Управляйте ей через query-параметры:

ПараметрТипОписание
pageintegerНомер страницы (начиная с 1)
per-pageintegerКоличество элементов на страницу (1–250, по умолчанию 100)

Метаданные пагинации возвращаются в HTTP-заголовках ответа:

ЗаголовокОписание
X-Pagination-Total-CountОбщее число записей
X-Pagination-Page-CountОбщее число страниц
X-Pagination-Current-PageТекущая страница
X-Pagination-Per-PageЗаписей на странице

Лимиты запросов

Для защиты инфраструктуры API применяет ограничение частоты запросов (rate limiting). При превышении лимита сервер вернёт код 429.

Рекомендации

  • Кэшируйте ответы, которые меняются редко (справочник площадок, профиль)
  • Используйте per-page для получения данных пакетами, а не по одной записи
  • При получении 429 сделайте паузу и повторите запрос через несколько секунд
  • Для массовых операций лучше использовать вебхуки и уведомления через Telegram

Авторизация

Получите JWT-токен для доступа к защищённым методам API. Токен передаётся в заголовке Authorization: Bearer <jwt>.

POST /v1/user/login

Авторизация пользователя. Возвращает JWT-токен для последующих запросов.

Параметры запроса

ПараметрТипОписание
emailобязательныйstringEmail пользователя
passwordобязательныйstringПароль

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Пользователь авторизован.",
  "data": {
    "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
  }
}
400 Error 
"Вы ввели неверный адрес электронной почты или пароль."

Пример запроса

curl -X POST "https://myreviews.dev/v1/user/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"mypassword"}'
import requests

r = requests.post("https://myreviews.dev/v1/user/login",
    json={"email": "user@example.com", "password": "mypassword"})
jwt = r.json().get("data", {}).get("jwt")
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => 'Content-Type: application/json',
    'content' => json_encode([
        'email'    => 'user@example.com',
        'password' => 'mypassword',
    ]),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/user/login', false, $ctx),
    true
);
$jwt = $data['data']['jwt'] ?? null;
const res = await fetch("https://myreviews.dev/v1/user/login", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    email: "user@example.com",
    password: "mypassword"
  })
});
const { data } = await res.json();
const jwt = data.jwt;

Профиль

🔒 Все методы требуют Authorization: Bearer <jwt>
GET /v1/user/profile

Получение данных текущего пользователя.

🔒 Авторизация

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Данные пользователя.",
  "data": {
    "id": 1,
    "email": "user@example.com",
    "name": "Иван",
    "surname": "Иванов",
    "phone": "+79001234567",
    "about": "",
    "image": null,
    "date_reg": "15.02.2024",
    "telegram_chat_id": null
  }
}

Пример запроса

curl "https://myreviews.dev/v1/user/profile" \
  -H "Authorization: Bearer JWT"
r = requests.get("https://myreviews.dev/v1/user/profile",
    headers={"Authorization": f"Bearer {jwt}"})
$ctx = stream_context_create(['http' => [
    'method' => 'GET',
    'header' => "Authorization: Bearer $jwt",
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/user/profile', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/user/profile", {
  headers: { Authorization: "Bearer " + jwt }
});
const data = await res.json();
POST /v1/user/update

Обновление данных профиля пользователя.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
ProfileForm[name]stringИмя
ProfileForm[surname]stringФамилия
ProfileForm[phone]stringТелефон
ProfileForm[about]stringО себе
photo_uploadfileФото (multipart)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Данные пользователя отредактированы."
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/user/update" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"ProfileForm":{"name":"Иван","surname":"Иванов"}}'
r = requests.post("https://myreviews.dev/v1/user/update",
    headers={"Authorization": f"Bearer {jwt}"},
    json={"ProfileForm": {"name": "Иван", "surname": "Иванов"}})
$payload = ['ProfileForm' => ['name' => 'Иван', 'surname' => 'Иванов']];
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode($payload),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/user/update', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/user/update", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({
    ProfileForm: { name: "Иван", surname: "Иванов" }
  })
});

Организации

🔒 Все методы, кроме view, требуют авторизации
GET /v1/firm/list

Список организаций текущего пользователя.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
per-pageintКоличество на странице (по умолчанию 100, макс. 250)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Организации пользователя.",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "ООО Рога и копыта",
      "address": "Москва, ул. Примерная, 1",
      "image": null,
      "active": true,
      "date_create": "01.01.2024"
    }
  ]
}

Пример запроса

curl "https://myreviews.dev/v1/firm/list?per-page=20" \
  -H "Authorization: Bearer JWT"
r = requests.get("https://myreviews.dev/v1/firm/list",
    params={"per-page": 20},
    headers={"Authorization": f"Bearer {jwt}"})
$ctx = stream_context_create(['http' => [
    'method' => 'GET',
    'header' => "Authorization: Bearer $jwt",
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/list?per-page=20', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/list?per-page=20", {
  headers: { Authorization: "Bearer " + jwt }
});
GET /v1/firm/view

Данные одной организации. Параметр id – UUID организации.

🌐 Публичный метод

Параметры запроса

ПараметрТипОписание
idобязательныйstring (UUID)UUID организации

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Данные организации.",
  "data": { "..." }
}

Пример запроса

curl "https://myreviews.dev/v1/firm/view?id=550e8400-e29b-41d4-a716-446655440000"
r = requests.get("https://myreviews.dev/v1/firm/view",
    params={"id": "550e8400-e29b-41d4-a716-446655440000"})
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/view?id=550e8400-e29b-41d4-a716-446655440000'),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/view?id=550e8400-e29b-41d4-a716-446655440000");
const data = await res.json();
POST /v1/firm/create

Создание новой организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
Firm[name]обязательныйstringНазвание организации
Firm[address]stringАдрес
Firm[type]intТип организации
Firm[photo_upload]fileЛоготип (multipart)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Организация создана.",
  "id": 43
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/firm/create" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"Firm":{"name":"Новая компания","address":"Москва, ул. Новая, 1"}}'
r = requests.post("https://myreviews.dev/v1/firm/create",
    headers={"Authorization": f"Bearer {jwt}"},
    json={"Firm": {"name": "Новая компания", "address": "Москва, ул. Новая, 1"}})
$payload = ['Firm' => ['name' => 'Новая компания', 'address' => 'Москва, ул. Новая, 1']];
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode($payload),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/create', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({
    Firm: { name: "Новая компания", address: "Москва, ул. Новая, 1" }
  })
});
POST /v1/firm/update

Обновление данных организации. Параметр id – UUID организации в query-строке.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
idобязательныйstring (UUID)UUID организации (query)
Firm[name]stringНазвание
Firm[address]stringАдрес

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Данные организации отредактированы."
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/firm/update?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"Firm":{"name":"Новое название"}}'
r = requests.post("https://myreviews.dev/v1/firm/update",
    params={"id": "550e8400-e29b-41d4-a716-446655440000"},
    headers={"Authorization": f"Bearer {jwt}"},
    json={"Firm": {"name": "Новое название"}})
$payload = ['Firm' => ['name' => 'Новое название']];
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode($payload),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/update?id=550e8400-e29b-41d4-a716-446655440000', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/update?id=550e8400-e29b-41d4-a716-446655440000", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({ Firm: { name: "Новое название" } })
});
GET /v1/firm/delete

Удаление организации. Только для владельца.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
idобязательныйstring (UUID)UUID организации

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Организация удалена."
}

Пример запроса

curl "https://myreviews.dev/v1/firm/delete?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer JWT"
r = requests.get("https://myreviews.dev/v1/firm/delete",
    params={"id": "550e8400-e29b-41d4-a716-446655440000"},
    headers={"Authorization": f"Bearer {jwt}"})
$ctx = stream_context_create(['http' => [
    'method' => 'GET',
    'header' => "Authorization: Bearer $jwt",
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/delete?id=550e8400-e29b-41d4-a716-446655440000', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/delete?id=550e8400-e29b-41d4-a716-446655440000", {
  headers: { Authorization: "Bearer " + jwt }
});

Площадки отзывов

GET /v1/firm/services

Список всех доступных площадок для отзывов.

🌐 Публичный метод

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Сервисы",
  "data": [
    { "id": 1, "name": "Яндекс" },
    { "id": 2, "name": "Google" },
    { "id": 3, "name": "2Gis" }
  ]
}

Пример запроса

curl "https://myreviews.dev/v1/firm/services"
r = requests.get("https://myreviews.dev/v1/firm/services")
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/services'),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/services");
const data = await res.json();
POST /v1/firm/add-service

Привязка площадки к организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
idобязательныйstring (UUID)UUID организации (query)
serviceобязательныйintID площадки (body)
urlобязательныйstringСсылка на профиль организации на площадке (body)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Новая площадка добавлена.",
  "data": { "..." }
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/firm/add-service?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"service":1,"url":"https://yandex.ru/maps/..."}'
r = requests.post("https://myreviews.dev/v1/firm/add-service",
    params={"id": "550e8400-e29b-41d4-a716-446655440000"},
    headers={"Authorization": f"Bearer {jwt}"},
    json={"service": 1, "url": "https://yandex.ru/maps/..."})
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode([
        'service' => 1,
        'url'     => 'https://yandex.ru/maps/...',
    ]),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/add-service?id=550e8400-e29b-41d4-a716-446655440000', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/add-service?id=550e8400-e29b-41d4-a716-446655440000", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({ service: 1, url: "https://yandex.ru/maps/..." })
});
POST /v1/firm/delete-service

Отвязка площадки от организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
idобязательныйstring (UUID)UUID организации (query)
serviceобязательныйintID площадки (body)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Площадка удалена"
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/firm/delete-service?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"service":1}'
r = requests.post("https://myreviews.dev/v1/firm/delete-service",
    params={"id": "550e8400-e29b-41d4-a716-446655440000"},
    headers={"Authorization": f"Bearer {jwt}"},
    json={"service": 1})
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode(['service' => 1]),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/delete-service?id=550e8400-e29b-41d4-a716-446655440000', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/delete-service?id=550e8400-e29b-41d4-a716-446655440000", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({ service: 1 })
});

Отзывы

GET /v1/review/index

Список отзывов с фильтрацией и пагинацией. Если firm_id не указан – отзывы по всем организациям пользователя.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
ReviewSearch[firm_id]string (UUID)UUID организации
ReviewSearch[service]intID площадки
ReviewSearch[username]stringИмя автора
ReviewSearch[date_create]stringДата (дд.мм.гггг)
sortstringСортировка: +id, -id, +date_create, -date_create
pageintНомер страницы
per-pageintКоличество на странице (1–250)
Пагинация в заголовках ответа:
  • X-Pagination-Total-Count – общее количество записей
  • X-Pagination-Page-Count – количество страниц
  • X-Pagination-Current-Page – текущая страница
  • X-Pagination-Per-Page – записей на странице

Пример запроса

curl "https://myreviews.dev/v1/review/index?ReviewSearch[firm_id]=550e8400-e29b-41d4-a716-446655440000&page=1&per-page=25" \
  -H "Authorization: Bearer JWT"
r = requests.get("https://myreviews.dev/v1/review/index",
    params={"ReviewSearch[firm_id]": "550e8400-e29b-41d4-a716-446655440000", "page": 1, "per-page": 25},
    headers={"Authorization": f"Bearer {jwt}"})
total = r.headers.get("X-Pagination-Total-Count")
$ctx = stream_context_create(['http' => [
    'method' => 'GET',
    'header' => "Authorization: Bearer $jwt",
]]);
$url = 'https://myreviews.dev/v1/review/index?'
     . http_build_query(['ReviewSearch' => ['firm_id' => '550e8400-e29b-41d4-a716-446655440000'], 'page' => 1, 'per-page' => 25]);
$data = json_decode(file_get_contents($url, false, $ctx), true);
const res = await fetch(
  "https://myreviews.dev/v1/review/index?ReviewSearch[firm_id]=550e8400-e29b-41d4-a716-446655440000&page=1&per-page=25",
  { headers: { Authorization: "Bearer " + jwt } }
);
const total = res.headers.get("X-Pagination-Total-Count");
const data = await res.json();

Теги

GET /v1/firm/tags

Облако тегов (ключевые слова) из отзывов организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
idобязательныйstring (UUID)UUID организации

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Теги организации.",
  "data": [ "..." ]
}

Пример запроса

curl "https://myreviews.dev/v1/firm/tags?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer JWT"
r = requests.get("https://myreviews.dev/v1/firm/tags",
    params={"id": "550e8400-e29b-41d4-a716-446655440000"},
    headers={"Authorization": f"Bearer {jwt}"})
$ctx = stream_context_create(['http' => [
    'method' => 'GET',
    'header' => "Authorization: Bearer $jwt",
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/firm/tags?id=550e8400-e29b-41d4-a716-446655440000', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/firm/tags?id=550e8400-e29b-41d4-a716-446655440000", {
  headers: { Authorization: "Bearer " + jwt }
});
const data = await res.json();
POST /v1/review/create-tag

Добавление тега к отзыву. Только владелец организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
review_idобязательныйintID отзыва (query)
ReviewTag[content]обязательныйstringТекст тега (body)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Тег создан",
  "data": { "..." }
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/review/create-tag?review_id=100" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"ReviewTag":{"content":"отличный сервис"}}'
r = requests.post("https://myreviews.dev/v1/review/create-tag",
    params={"review_id": 100},
    headers={"Authorization": f"Bearer {jwt}"},
    json={"ReviewTag": {"content": "отличный сервис"}})
$payload = ['ReviewTag' => ['content' => 'отличный сервис']];
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode($payload),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/review/create-tag?review_id=100', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/review/create-tag?review_id=100", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({ ReviewTag: { content: "отличный сервис" } })
});
POST /v1/review/delete-tag

Удаление ручного тега. Автоматические теги удалить нельзя.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
tag_idобязательныйintID тега

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Тег успешно удален"
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/review/delete-tag" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"tag_id":5}'
r = requests.post("https://myreviews.dev/v1/review/delete-tag",
    headers={"Authorization": f"Bearer {jwt}"},
    json={"tag_id": 5})
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode(['tag_id' => 5]),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/review/delete-tag', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/review/delete-tag", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({ tag_id: 5 })
});

Ответы на отзывы

POST /v1/review/create-answer

Создание и отправка ответа (или жалобы) на отзыв. Только владелец организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
review_idобязательныйintID отзыва (query)
complainобязательныйint0 – ответ, 1 – жалоба (query)
ReviewAnswer[message]обязательныйstringТекст ответа (body)

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Ответ создан",
  "data": {
    "id": 1,
    "message": "Спасибо!",
    "status": 0
  }
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/review/create-answer?review_id=100&complain=0" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"ReviewAnswer":{"message":"Спасибо за отзыв!"}}'
r = requests.post("https://myreviews.dev/v1/review/create-answer",
    params={"review_id": 100, "complain": 0},
    headers={"Authorization": f"Bearer {jwt}"},
    json={"ReviewAnswer": {"message": "Спасибо за отзыв!"}})
$payload = ['ReviewAnswer' => ['message' => 'Спасибо за отзыв!']];
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode($payload),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/review/create-answer?review_id=100&complain=0', false, $ctx),
    true
);
const res = await fetch(
  "https://myreviews.dev/v1/review/create-answer?review_id=100&complain=0",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer " + jwt
    },
    body: JSON.stringify({ ReviewAnswer: { message: "Спасибо за отзыв!" } })
  }
);
GET /v1/review/generate-answer

Генерация текста ответа с помощью ИИ. Только владелец организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
review_idобязательныйintID отзыва
complainобязательныйint0 – ответ, 1 – жалоба

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Ответ сгенерирован",
  "data": "Сгенерированный текст ответа"
}

Пример запроса

curl "https://myreviews.dev/v1/review/generate-answer?review_id=100&complain=0" \
  -H "Authorization: Bearer JWT"
r = requests.get("https://myreviews.dev/v1/review/generate-answer",
    params={"review_id": 100, "complain": 0},
    headers={"Authorization": f"Bearer {jwt}"})
$ctx = stream_context_create(['http' => [
    'method' => 'GET',
    'header' => "Authorization: Bearer $jwt",
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/review/generate-answer?review_id=100&complain=0', false, $ctx),
    true
);
const res = await fetch(
  "https://myreviews.dev/v1/review/generate-answer?review_id=100&complain=0",
  { headers: { Authorization: "Bearer " + jwt } }
);
const data = await res.json();
POST /v1/review/delete-answer

Удаление ответа на отзыв. Только владелец организации.

🔒 Авторизация

Параметры запроса

ПараметрТипОписание
answer_idобязательныйintID ответа

Пример ответа

200 OK 
{
  "status": 200,
  "message": "Ответ успешно удален"
}

Пример запроса

curl -X POST "https://myreviews.dev/v1/review/delete-answer" \
  -H "Authorization: Bearer JWT" \
  -H "Content-Type: application/json" \
  -d '{"answer_id":1}'
r = requests.post("https://myreviews.dev/v1/review/delete-answer",
    headers={"Authorization": f"Bearer {jwt}"},
    json={"answer_id": 1})
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer $jwt\r\nContent-Type: application/json",
    'content' => json_encode(['answer_id' => 1]),
]]);
$data = json_decode(
    file_get_contents('https://myreviews.dev/v1/review/delete-answer', false, $ctx),
    true
);
const res = await fetch("https://myreviews.dev/v1/review/delete-answer", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer " + jwt
  },
  body: JSON.stringify({ answer_id: 1 })
});

Справочник площадок

Таблица соответствия числовых ID и названий площадок. Актуальный список можно получить через GET /v1/firm/services.

IDПлощадка
1Яндекс
2Google
32ГИС
4Zoon
5Yell
6MyReviews
7ПроДокторов
8Flamp
10Otzovik
12Яндекс.Услуги
13Авито
14На Поправку
15Яндекс.Бизнес
16СберЗдоровье
17Т-БАНК
18ВКонтакте
19Trustpilot
21IRecommend
22Перекрёсток
23Metro
24Магнит
info@myreviews.ru
Логоти dzen.ru
логотип сервиса по сбору отзывов MyReviews
Символы </>
Виджет с отзывами на ваш сайт
Увеличивайте количество лидов благодаря положительным отзывам
Геометка на карте
Ежедневный мониторинг
Отслеживайте отзывы о компании на геосервисах и отзовиках
Человек с сердцем
Перехват негатива
Решайте вопросы напрямую с клиентом
QR-код для отзывов
QR-код для сбора отзывов
Персональный QR-код упростит сбор новых отзывов
Логотип Telegram
Бот в Telegram
Получайте уведомления о новых отзывах в мессенджере
График и статистика
Аналитика
Ценные инсайты для принятия решений в бизнесе
Сердце с пульсом
Медицина
Повышайте рейтинг клиники на всех топовых площадках сразу
Киоск
Маркетплейсы
Анализируйте отзывы и будьте в курсе трендов
Помада и зеркало
Салоны красоты
Добавьте эстетичный блок с отзывами на сайт вашего салона
Вилка и ложка
Рестораны и кафе
Станьте заметнее на картах благодаря лояльным клиентам
Кровать в отеле
Отели
Организуйте непрерывный сбор обратной связи от гостей
Инструменты
Автомастерские
Прокачайте отзывы на геосервисах – клиенты сами найдут вас
Геосервисы
Логотип Яндекс Карт
Яндекс Карты
Логотип 2GIS
2ГИС
Логотип Гугл Карт
Google Maps
Логотип Zoon
Zoon
Логотип Флампа
Flamp
Логотип Yell.ru
Yell
Онлайн компаниям
Логотип Яндекс Бизнеса
Яндекс Бизнес
Логотип Avito
Авито
Логотип ВКонтакте
ВКонтакте
новое
Логотип Otzovik
Отзовик
Логотип Tbank
Т-Банк отзывы
Логотип Яндекс.Услуг
Яндекс Услуги
Медицина
Логотип Prodoctorov
ПроДокторов
Логотип Napopravku
НаПоправку
Логотип Sberhealth
СберЗдоровье