Обзор / Журнал изменений
Журнал изменений
Ломающие изменения выносим в новую версию пути. Внутри v1 добавляются только поля и методы, а помеченное устаревшим живёт не меньше шести месяцев.
Как мы версионируем
Версия API - в пути (/v1). Версия клиента - обычная семантическая: первое число совпадает с версией API, второе растёт от новых методов, третье - от исправлений. Обновление клиента внутри одного первого числа безопасно.
v1текущая версия API
1.8.3клиент Node.js и CLI
6 мес.минимальный срок жизни устаревшего
Выпуски
Пакет с повтором sku отвергается целиком
ИсправленоAPICLI- Пакет с повторяющимся
skuприменялся частично, теперь отвергается целиком с кодомbatch_duplicate_sku. - Утилита командной строки печатает итог
--dry-runтаблицей, а не построчно.
История остатка и событие stock.low
НовоеAPINode.jsPython- Добавлено:
GET /v1/stock/history- изменения остатка за период до 90 дней. - Добавлено: событие
stock.lowс порогом из кабинета. - Журнал доставок вебхуков хранится 30 дней вместо 7.
Асинхронный клиент для Python
НовоеPython- Класс
AsyncClientс тем же набором методов. - Исправлено:
iterate()терял последнюю страницу, если в ней ровно 200 записей.
Частичная отмена заказа
НовоеУстарелоAPI- Добавлено: частичная отмена заказа списком позиций.
- Устарело: поле
price_rubв ответах товаров. Живёт до 3 марта 2027, вместо негоpriceв копейках.
Клиент для PHP
НовоеPHP- Первый выпуск пакета для Composer: товары, остатки, заказы и проверка подписи вебхуков.
Курсоры во всех списках
НовоеУстарелоAPI- Курсорная пагинация во всех списках, смещения
offsetотключены. - Добавлен заголовок
Retry-Afterко всем ответам 429.
Первый публичный выпуск
Новое- Товары, остатки, заказы и вебхуки. Клиенты для Node.js и Python, утилита командной строки.