Быстрый старт

Пошаговый чек-лист интеграции — от получения доступов до обработки первого заказа.

• Один набор credentials для обоих API (Seller и B2B)
• TTL токена = 15 минут для обоих API

⚠ Частая ошибка: URL Lamoda Seller Partner API — это /jsonrpc, а не /jsonrpc/jsonrpc. Двойной путь — самая распространённая ошибка интеграции.

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

Чек-лист интеграции

1. Получение доступов

Примечание: Одни и те же credentials работают для Lamoda Seller Partner API и Lamoda B2B Platform Partner API.

2. Проверка авторизации

Вы можете получить токен двумя способами: через Lamoda Lamoda Seller Partner API или через B2B REST API.

Способ 1: Через Lamoda B2B Platform Partner API (REST)

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"
}'

Способ 2: Через Lamoda Lamoda Seller Partner API

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"
    }
}'

⚠ Важно: Поле "id" в JSON-RPC запросе должно быть строкой формата UUID v4 (36 символов). Пример: "550e8400-e29b-41d4-a716-446655440000". Произвольные строки (например, "test-auth") не пройдут валидацию.

Ожидаемый ответ:

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "token_type": "Bearer",
    "expires_in": 900,
    "scope": "partner_client r_orders c_order u_order c_shipments r_nomenclatures"
  }
}

Поля ответа

3. Использование токена

Передавайте токен в заголовке Authorization с префиксом Bearer:

curl -X GET 'https://api-b2b.lamoda.ru/api/v1/orders' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIs...'

Важно: Между словом Bearer и токеном должен быть ровно один пробел. Не используйте кавычки вокруг токена.

4. Минимальный FBS-сценарий

Подробнее о каждом шаге — в соответствующих разделах документации.

5. Рекомендация: логирование запросов

Для диагностики проблем рекомендуем логировать все API-запросы и ответы. Пример структуры лога:

{
  "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
  }
}

См. также

• Lamoda Seller Partner API vs Lamoda B2B Platform Partner API — какой API использовать
• Точки входа (endpoints) — полный список URL
• OAuth 2.0 авторизация — scopes и детали токенов
• FAQ