v1 на v2Здесь собраны только методы, где кроме адреса поменялось что-то ещё. Для каждого — что изменилось и что поправить. Нажмите на метод, чтобы раскрыть.
v1 продолжает работать как раньше — переходить можно постепенно, метод за методом.
/v1/ на /v2/. Методы, которых нет в этом списке, переносятся только этой заменой — тело запроса и ответ у них те же.X-API-Key и те же ключи.data. Там, где раньше в ответе был просто массив [...], теперь объект {"data": [...]}. Берите элементы из data.[ ...площадки... ]
{
"data": [ ...площадки... ]
}
Сами поля площадки не менялись — они просто переехали в поле data.
[ ...группы... ]
{
"data": [ ...группы... ],
"total": 342,
"limit": 100,
"offset": 0,
"has_next": true
}
Список теперь постраничный: группы в поле data, по 100 за раз (параметры limit / offset). has_next: true — есть ещё страницы.
[ ...ссылки... ]
{
"data": [ ...ссылки... ]
}
Метод всегда отдаёт сразу все ссылки группы — страниц нет. Сами поля ссылки не менялись, они просто переехали в поле data.
| Было | Стало | Что это | |
|---|---|---|---|
start_date | → | published_from | отзывы, опубликованные не раньше этой даты |
end_date | → | published_to | отзывы, опубликованные не позже этой даты |
has_replies | → | has_reply | только отзывы с ответом организации |
В каждом отзыве переименованы три поля:
| Было | Стало | |
|---|---|---|
author_name | → | author |
review_text | → | text |
rating_normalized | → | rating |
И одно поле внутри каждого элемента images:
| Было | Стало | |
|---|---|---|
image_url | → | template_url |
Значение то же — адрес картинки на CDN площадки «как есть». У части площадок (Яндекс, Островок, TripAdvisor, 2ГИС) он содержит шаблон размера ({size}, {width}/{height}) и потому сам по себе не открывается — новое имя честно об этом говорит. Для показа берите preview (миниатюра) или image (полный размер): они не менялись и всегда рабочие.
Остальные поля отзыва и формат страницы не менялись.
| Было | Стало | Что это | |
|---|---|---|---|
date_from | → | published_from | начало периода (по дате публикации отзыва) |
date_to | → | published_to | конец периода |
В ответе есть блок meta (он был и в v1) — сервер возвращает в нём фактически применённый период. Поля внутри meta переименованы так же, как параметры:
| Было | Стало | |
|---|---|---|
date_from | → | published_from |
date_to | → | published_to |
Остальные данные (сводка, разбивка по площадкам) не менялись.
| Было | Стало | Что это | |
|---|---|---|---|
date_from | → | published_from | начало периода (по дате публикации отзыва) |
date_to | → | published_to | конец периода |
В ответе есть блок meta (он был и в v1) — сервер возвращает в нём фактически применённый период. Поля внутри meta переименованы так же, как параметры:
| Было | Стало | |
|---|---|---|
date_from | → | published_from |
date_to | → | published_to |
Сами точки графика (series) не менялись.
| Было | Стало | Что это | |
|---|---|---|---|
start_date | → | published_from | отзывы, опубликованные не раньше этой даты |
end_date | → | published_to | отзывы, опубликованные не позже этой даты |
has_replies | → | has_reply | только отзывы с ответом организации |
В каждом отзыве переименованы поля:
| Было | Стало | |
|---|---|---|
author_name | → | author |
review_text | → | text |
rating_normalized | → | rating |
images[].image_url | → | images[].template_url |
| Было | Стало | Что это | |
|---|---|---|---|
start_date | → | published_from | отзывы, опубликованные не раньше этой даты |
end_date | → | published_to | отзывы, опубликованные не позже этой даты |
has_replies | → | has_reply | только отзывы с ответом организации |
| — | + | limit / offset | новые: постраничный вывод |
Список стал постраничным (отзывы в data, рядом счётчики total / has_next), и в каждом отзыве переименованы поля:
| Было | Стало | |
|---|---|---|
author_name | → | author |
review_text | → | text |
rating_normalized | → | rating |
images[].image_url | → | images[].template_url |
Список закреплённых теперь в поле data, и в каждом отзыве переименованы поля:
| Было | Стало | |
|---|---|---|
author_name | → | author |
review_text | → | text |
rating_normalized | → | rating |
images[].image_url | → | images[].template_url |
Тело запроса (порядок id закреплённых отзывов) не меняется.
Список закреплённых теперь в поле data, и в каждом отзыве переименованы поля:
| Было | Стало | |
|---|---|---|
author_name | → | author |
review_text | → | text |
rating_normalized | → | rating |
images[].image_url | → | images[].template_url |
Тело запроса (список id для закрепления в конец) не меняется.
Оставшиеся закреплённые теперь в поле data, и в каждом отзыве переименованы поля:
| Было | Стало | |
|---|---|---|
author_name | → | author |
review_text | → | text |
rating_normalized | → | rating |
images[].image_url | → | images[].template_url |
Тело запроса (список id для открепления) не меняется.
Здесь нет соответствия в /v1 — это не переименование, а новая возможность. Замена /v1/ на /v2/ её не даст.
Папки групп. Позволяют спросить отзывы и аналитику сразу по нескольким объектам одним параметром: ?folder_id= вместо ?group_id= на GET /v2/reviews, GET /v2/analytics и /timeseries.
Глубина — два уровня: папка → подпапка → группы. Одна группа может лежать в скольких угодно папках. Управление — четыре метода: POST, GET, PATCH /v2/folders/{folder_id}, DELETE /v2/folders/{folder_id}.
Адресовать нужно ровно один объект: group_id и folder_id вместе дадут 400, без обоих — тоже 400. В папочном режиме закрепления не применяются, а флаги is_hidden / is_pinned / pin_position не отдаются. На /public-зеркалах папок нет.
Подробности — в руководстве по папкам.
Не нашли здесь свой метод? Значит, он переносится простой заменой /v1/ на /v2/ в адресе — всё остальное у него без изменений.