Изменения

Правила совместимости#

Адрес версии — /api/v1. Внутри v1 изменения только совместимые:

• добавляются методы, необязательные поля запросов и новые поля ответов;
• добавляются значения перечислений — например, новые reason в выдаче или коды отказа событий;
• существующие поля не удаляются и не меняют смысл.

Поэтому игнорируйте неизвестные поля в ответах и обрабатывайте неизвестные значения перечислений как «прочее». Несовместимые изменения выйдут новой версией API с отдельным адресом и заранее объявленным сроком перехода.

В журнале — только методы, которые уже работают: новый метод появляется здесь с датой, с которой его можно вызывать. Полный список действующих методов — в справочнике API.

14 сентября 2026 — первая версия API v1#

• Объекты: PUT, PATCH, DELETE /items/{id}, пакет POST /items/batch, объект с результатами анализа GET /items/{id}, переобработка POST /items/{id}/reprocess, сверка каталога GET /items.
• События и заказы: POST /events, GET /event-types, POST /orders, POST /orders/batch.
• Пользователи: склейка POST /users/link, профиль POST /users/profile и пакет POST /users/profile/batch, сверка GET /users/profile, удаление POST /users/delete.
• Служебное: GET /health, описание API GET /openapi.json.