На этой странице представлена информация о версиях API Lamoda, какая из них актуальна и по каким правилам мы меняем API-контракты.
Актуальная версия
Сейчас актуальна Lamoda Seller Partner API v2 — единый REST API, который работает для обеих моделей сотрудничества (FBS и FBO). Все новые интеграции стройте на нём.
- Протокол: REST, обмен данными в JSON.
- Базовый URL:
https://public-api-seller.lamoda.ru/api. - Авторизация: OAuth 2.0, метод
POST /v2/auth-token(подробнее — в статье «Начало работы и авторизация»).
Предыдущие версии
До появления v2 партнёры работали с двумя разными API. Сейчас оба постепенно выводятся из эксплуатации, поэтому новые задачи стоит сразу решать на v2.
| API | Протокол | Статус |
|---|---|---|
| Lamoda Seller Partner API v1 | JSON-RPC 2.0 (POST / с методом в теле) | Будет отключена 01.01.27, необходима миграция на v2 |
| Lamoda B2B Platform Partner API v1 | REST (/api/v1/…) | Будет отключена 01.01.27, необходима миграция на v2 |
Что именно и как переносить, описано в разделе «Переход на Lamoda Seller API v2».
Как узнавать об изменениях
Следить за обновлениями API удобно по трём источникам:
- Telegram-канал @apilamoda — оперативные анонсы технических изменений. Не отключайте уведомления: публикации редкие, но каждая может задеть интеграцию.
- Справочник методов — всегда актуальная спецификация v2.
- История изменений API — хронология обновлений в этом же разделе.
Обратная совместимость
Мы стараемся развивать API так, чтобы существующие интеграции продолжали работать без доработок.
Совместимые изменения мы вносим в рабочем порядке, без отдельного анонса, — они не затрагивают то, что уже используется:
- новые методы;
- новые поля в ответах;
- новые опциональные параметры;
- новые значения в enum-полях (например, новый статус).
| ℹ️ Поэтому ваш JSON-парсер должен игнорировать незнакомые поля, а обработчик статусов — корректно вести себя при появлении нового значения. |
Несовместимые изменения затрагивают действующие контракты, поэтому о них мы предупреждаем заранее:
- удаление методов или полей;
- изменение типа данных;
- новый обязательный параметр;
- изменение смысла существующего поля.
Сроки анонсирования
Насколько заранее мы предупреждаем об изменении, зависит от его типа:
| Тип изменения | Минимальный срок предупреждения |
|---|---|
| Новые методы и поля | без предупреждения |
| Изменение поведения существующего метода | 2–4 недели |
| Новый обязательный параметр | 4+ недели |
| Депрекация метода | 3+ месяца |
Deprecated-методы
Методы, которые выводятся из эксплуатации, помечаются в спецификации как deprecated. Переносите вызовы на актуальные методы заранее: после отключения deprecated-метод перестаёт отвечать. Подходящую замену ищите в справочнике методов или уточняйте в поддержке.
См. также
Помогла эта информация?
Спасибо за отзыв