Версионирование

Текущая версия — /v2

/v2 — канонический namespace Rewio API. Именно его следует использовать в новых интеграциях. Весь клиентский функционал зеркалируется в /v2 с едиными правилами именования:

• имена полей: author / text / rating (не author_name / review_text / …);
• диапазоны: *_from / *_to (включительно);
• курсоры: *_after / *_before (напр. updated_after);
• конверт списков: {data, total, limit, offset, has_next} либо {data};
• ключ элементов списка всегда data.

/v1 заморожен и deprecated

Версия /v1 заморожена: имена сохранены байт-в-байт для существующих интеграций, вносятся только security-фиксы, новых возможностей не добавляется. Она помечена deprecated и со временем будет выведена из эксплуатации (sunset).

• Новые интеграции — только на /v2.
• Мигрируете с /v1? Соответствие имён и полей — в карте переименований проекта (docs/API_NAMING.md).

Форматы и совместимость

• Поля могут добавляться в ответы без смены версии — парсите ответ терпимо (игнорируйте незнакомые поля), не полагайтесь на порядок ключей.
• Ломающие изменения формы ответа выходят только под новым номером версии.