Содержание статьи
Политика обратной совместимости
Гарантии совместимости
- Изменения с обратной совместимостью (backwards compatible):
- Добавление новых полей в ответы
- Добавление новых методов
- Добавление новых опциональных параметров
- Добавление новых значений в enum-поля (например, новые статусы)
- Изменения без обратной совместимости (breaking changes):
- Удаление полей или методов
- Изменение типов данных
- Добавление обязательных параметров
- Изменение семантики существующих полей
Рекомендация: Ваш JSON-парсер должен игнорировать неизвестные поля. Новые поля и значения enum могут появиться в ответах без предупреждения.
Сроки анонсирования
| Тип изменения | Минимальный срок уведомления |
| Добавление новых методов/полей | Без предупреждения |
| Изменение поведения существующих методов | 2–4 недели |
| Добавление обязательных параметров | 4+ недели |
| Депрекейт методов | 3+ месяца |
Deprecated-методы
Методы, которые больше не поддерживаются, помечены в OpenAPI-спецификации как deprecated. При вызове deprecated-метода вы получите ответ с сообщением об этом:
{
"jsonrpc": "2.0",
"id": "550e8400-e29b-41d4-a716-446655440000",
"result": {
"message": "В связи с запуском нового личного кабинета Lamoda Seller запросы к API Seller Center больше не поддерживаются. Необходимо перейти на новую версию API, инструкция по подключению — https://lamoda.academy-seller.ru/..."
}
}
Важно: Если вы получаете подобное сообщение, значит используемый вами метод более не поддерживается. Обратитесь к актуальной OpenAPI-спецификации для поиска замены.
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить