NNimbusДокументация
Обзор / Журнал изменений

Журнал изменений

Ломающие изменения выносим в новую версию пути. Внутри 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, утилита командной строки.