Что мы считаем совместимым#
Без предупреждения мы можем добавить:
- новое поле в ответе;
- новое значение в перечислении, которое возвращается (не принимается);
- новый необязательный параметр запроса;
- новый метод.
Разбор ответа на стороне интеграции должен переживать незнакомое поле. Удаление, переименование или смена типа считаются несовместимым изменением, о таком предупредим заранее.
Август 2026. Запуск обновлённого External API v2#
Первый публичный релиз второй версии API. Ключевое:
- доступ от лица сотрудника: ключ выдаётся человеку, права и список доступных центров определяются его ролями на каждом запросе;
- тариф закреплён за торговым центром — Basic и PRO, состав в разделе Тарифы;
- методы на чтение и на запись: продажи, чеки с позициями, посещаемость, кассы, аномалии, сдача товарооборота и передача посещаемости.
Для интеграций с API v1 версии несовместимы: токены различаются в обе стороны, все суммы в v2 приходят и принимаются в копейках, методы и форматы ответов другие. Маршрут переезда описан в разделах Авторизация и Все методы.