Единый формат ответов, пагинация и фильтры — переход со старой версии займёт один вечер.
Первая версия API вышла в 2021 году и с тех пор обрастала новыми возможностями: рекомендации, визуальный поиск, персонализация. Каждая функция добавлялась по мере появления, и формат ответов постепенно стал неоднородным.
API v2 наводит порядок. Все методы возвращают данные в едином формате, поэтому интеграцию писать и поддерживать проще. Появилась единообразная пагинация для постраничной выдачи результатов. Фильтры задаются одинаково во всех методах.
Мы также улучшили документацию: для каждого метода есть описание параметров, примеры запросов и ответов и описание ошибок.
Переход со старой версии займёт один вечер: изменения в основном касаются формата ответов, а логика работы осталась прежней. В документации есть подробное руководство по переходу.
Первая версия API продолжит работать, но новые функции будут появляться только во второй. Рекомендуем запланировать переход в ближайшие месяцы.