2.1 Точки входа (endpoints)

Lamoda предоставляет API для интеграции с платформой. В этом разделе описаны все точки входа и требования к запросам.

Получение учётных данных (credentials)

Для работы с API необходимы client_id и client_secret → Авторизация OAuth 2.0.

B2B Platform API (REST)

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

Основные точки входа B2B Platform API v1

Пример запроса к B2B Platform 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'

Seller API (JSON-RPC)

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

Важно: URL Seller API — это /jsonrpc, а не /jsonrpc/jsonrpc. Двойной путь — частая ошибка интеграции.

Основные методы Seller API

Полная спецификация: Lamoda Seller Partner API

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

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.nomenclatures.list",
    "params": {
      "pagination": {
        "page": 1,
        "limit": 10
      }
    }
}'

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

Для авторизации используется OAuth 2.0 с типом гранта client_credentials.

Получение токена через B2B Platform API

curl -X POST 'https://api-b2b.lamoda.ru/auth/token' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
}'

Получение токена через Seller API (JSON-RPC)

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc/v1/tokens.create' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "method": "v1.tokens.create",
    "params": {
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET",
      "grant_type": "client_credentials"
    }
}'

Важно: Время жизни токена (TTL) — 15 минут (900 секунд). Обновляйте токен до истечения срока действия. Подробнее см. OAuth 2.0 авторизация.

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

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

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

• Двойной путь /jsonrpc/jsonrpc вместо /jsonrpc
• GET вместо POST для получения токена
• Отсутствие пробела после "Bearer" в заголовке Authorization
• Параметры строки запроса вместо JSON-тела для токена

Логирование

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

• Время запроса (timestamp)
• HTTP-метод и полный URL
• Заголовки запроса (без secrets)
• Тело запроса (для 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": "RU250120-123456-001"},
    "duration_ms": 245
  }
}

Спецификация API

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

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

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

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

См. также

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