Точки входа API

Lamoda предоставляет два окружения для интеграции: тестовое (Demo) и боевое (Prod). Каждое окружение имеет собственные точки входа для API и веб-интерфейса.

Окружения API

B2B Platform API (REST)

Основной REST API для работы с заказами, отгрузками, поставками, остатками.

Пример запроса к Prod API

curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders?limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Пример запроса к Demo API

curl -X GET "https://api-demo-b2b.lamoda.ru/api/v1/orders?limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Seller API (JSON-RPC)

JSON-RPC API для работы с номенклатурой, ценами, атрибутами.

Пример JSON-RPC запроса

curl -X POST "https://public-api-seller.lamoda.ru/jsonrpc/jsonrpc" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "unique-request-id",
    "method": "v1.nomenclatures.list",
    "params": {
      "limit": 10,
      "offset": 0
    }
  }'

Авторизация (OAuth2)

Получение токена

curl -X GET "https://api-b2b.lamoda.ru/auth/token?client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

Веб-интерфейс (Личный кабинет)

Этапы интеграции

1. Получение credentials
   Запросите у sales-manager ключи client_id и client_secret для Demo и Prod окружений.
2. Тестирование на Demo
   Разработка и отладка интеграции на https://api-demo-b2b.lamoda.ru. Данные в Demo окружении тестовые.
3. Стабилизация на Prod
   Переключение на https://api-b2b.lamoda.ru. Работа с реальными заказами и товарами.

Переключение между окружениями

При переходе с Demo на Prod необходимо:

Чек-лист перехода на Prod:

• Заменить base URL с api-demo-b2b на api-b2b
• Использовать Prod credentials (они отличаются от Demo)
• Убедиться, что SKU товаров совпадают с реальными артикулами
• Предоставить боевой URL для нотификаций
• Включить логирование всех запросов и ответов

Частые ошибки:

• Использование Demo credentials на Prod
• URL содержит "demo" в production-коде
• Несоответствие SKU между системами
• Отсутствие обработки ошибок авторизации

Требования к запросам

Логирование

Для быстрой диагностики проблем логируйте:

• Время запроса
• HTTP-метод и полный URL с query-параметрами
• Заголовки запроса
• Тело запроса (для POST/PUT/PATCH)
• Код ответа HTTP
• Тело ответа
• Время выполнения запроса

Пример структуры лога

{
  "timestamp": "2025-01-20T14:30:00.123Z",
  "request": {
    "method": "POST",
    "url": "https://api-b2b.lamoda.ru/api/v1/orders",
    "headers": {
      "Authorization": "Bearer ***",
      "Content-Type": "application/json"
    },
    "body": {"items": [...]}
  },
  "response": {
    "status": 201,
    "body": {"orderId": "CZ123456789"},
    "duration_ms": 245
  }
}

API Specification

Актуальная спецификация API доступна:

• B2B Platform API: OpenAPI Specification
• Seller API: Lamoda Seller Partner API

Обратная совместимость

Важно: JSON-формат подразумевает возможность добавления новых полей в ответы API без предупреждения. Это обратносовместимая операция. Убедитесь, что ваш парсер игнорирует неизвестные поля.

См. также

• OAuth 2.0 авторизация
• Быстрый старт
• Чек-лист интеграции