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

Обновлено

16.02.2026

Содержание статьи

<h1>1.2 Быстрый старт</h1> 
 
Пошаговый чек-лист интеграции — от получения доступов до обработки первого заказа. 
 
Ключевые факты перед началом: 
<ul> 
<li>Один набор credentials для обоих API (Seller и B2B)</li> 
<li>TTL токена = 15 минут для обоих API</li> 
<li>Используйте <a href="16_1_postman_collection.html">Postman-коллекции</a> для быстрого старта</li> 
</ul> 
 
 
⚠ Частая ошибка: URL Seller API — это <code>/jsonrpc</code>, а не <code>/jsonrpc/jsonrpc</code>. Двойной путь — самая распространённая ошибка интеграции. 
 
 
Обратная совместимость: JSON-формат подразумевает возможность добавления новых полей в ответы API без предупреждения. Это обратносовместимая операция. Убедитесь, что ваш парсер игнорирует неизвестные поля. 
 
<h2>Чек-лист интеграции</h2> 
 
<h3>1. Получение доступов</h3> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Что получить</td> 
<td style="border: 1px solid #ddd; padding: 8px;">От кого</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Для чего</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>client_id</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Менеджер Lamoda (KAM)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Авторизация в API</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>client_secret</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Менеджер Lamoda (KAM)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Авторизация в API</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>partner_id</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Менеджер Lamoda (KAM)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Идентификация в запросах</td> 
</tr> 
</tbody> 
</table> 
 
Примечание: Одни и те же credentials работают для Seller API и B2B Platform API. 
 
<h3>2. Проверка авторизации</h3> 
 
Вы можете получить токен двумя способами: через Seller API (JSON-RPC) или через B2B REST API. 
 
 
<h4>Способ 1: Через B2B Platform API (REST)</h4> 
 
<pre><code>curl -X POST '<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/auth/token';">https://api-b2b.lamoda.ru/auth/token';</a> \ 
 -H 'Content-Type: application/json' \ 
 -d '{ 
 "client_id": "YOUR_CLIENT_ID", 
 "client_secret": "YOUR_CLIENT_SECRET", 
 "grant_type": "client_credentials" 
}'</code></pre> 
 
<h4>Способ 2: Через Seller API (JSON-RPC)</h4> 
 
 
 
<pre><code>curl -X POST '<a class="txttohtmllink" href="https://public-api-seller.lamoda.ru/jsonrpc/v1/tokens.create';">https://public-api-seller.lamoda.ru/jsonrpc/v1/tokens.create';</a> \ 
 -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" 
 } 
}'</code></pre> 
 
⚠ Важно: Поле <code>"id"</code> в JSON-RPC запросе должно быть строкой формата UUID v4 (36 символов). Пример: <code>"550e8400-e29b-41d4-a716-446655440000"</code>. Произвольные строки (например, <code>"test-auth"</code>) не пройдут валидацию. 
 
 
Ожидаемый ответ: 
 
<pre><code>{ 
 "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" 
 } 
}</code></pre> 
 
 
<h4>Поля ответа</h4> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Поле</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>access_token</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">JWT-токен для авторизации запросов</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>token_type</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Всегда <code>"Bearer"</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>expires_in</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Время жизни в секундах (900 = 15 минут)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>scope</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Список прав доступа через пробел</td> 
</tr> 
</tbody> 
</table> 
 
⚠ TTL = 15 минут! 
<code>expires_in: 900</code> = 900 секунд = 15 минут. 
Реализуйте автоматическое обновление токена. Рекомендуем кэшировать токен на <code>expires_in - 60</code> секунд. 
 
 
 
 
⚠ Ошибка 50400 "Партнер не найден"? 
Эта ошибка возникает при использовании grant type <code>client_credentials</code>. Проверьте <code>client_id</code> и <code>client_secret</code>. Убедитесь, что ваш аккаунт активирован менеджером Lamoda. 
 
<h3>3. Использование токена</h3> 
 
Передавайте токен в заголовке <code>Authorization</code> с префиксом <code>Bearer</code>: 
 
<pre><code>curl -X GET '<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/orders';">https://api-b2b.lamoda.ru/api/v1/orders';</a> \ 
 -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIs...'</code></pre> 
 
Важно: Между словом <code>Bearer</code> и токеном должен быть ровно один пробел. Не используйте кавычки вокруг токена. 
 
<h3>4. Минимальный FBS-сценарий</h3> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Шаг</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Действие</td> 
<td style="border: 1px solid #ddd; padding: 8px;">API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Метод</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">1</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Загрузите каталог</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Seller</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclatures.store</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">2</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Установите цены</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Seller</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclature.set-price</code> (FBS)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">3</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Обновите остатки</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Seller</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclatures.update-stock</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">4</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Получите заказы</td> 
<td style="border: 1px solid #ddd; padding: 8px;">B2B</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>GET /api/v1/orders</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">5</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Создайте отгрузку</td> 
<td style="border: 1px solid #ddd; padding: 8px;">B2B</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>POST /api/v1/shipments</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">6</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Напечатайте этикетки</td> 
<td style="border: 1px solid #ddd; padding: 8px;">B2B</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>GET /api/v1/label/*</code></td> 
</tr> 
</tbody> 
</table> 
 
Подробнее о каждом шаге — в соответствующих разделах документации. 
 
 
<h3>5. Рекомендация: логирование запросов</h3> 
 
Для диагностики проблем рекомендуем логировать все API-запросы и ответы. Пример структуры лога: 
 
<pre><code>{ 
 "timestamp": "2025-01-20T14:30:00.123Z", 
 "request": { 
 "method": "POST", 
 "url": "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/orders">https://api-b2b.lamoda.ru/api/v1/orders</a>", 
 "headers": { 
 "Authorization": "Bearer ***", 
 "Content-Type": "application/json" 
 }, 
 "body": {"items": ["..."]} 
 }, 
 "response": { 
 "status": 201, 
 "body": {"orderId": "RU250120-123456-001"}, 
 "duration_ms": 245 
 } 
}</code></pre> 
 
<h2>См. также</h2> 
 
<ul> 
<li><a href="0_5_seller_vs_b2b.html">Seller API vs B2B Platform</a> — какой API для чего</li> 
<li><a href="2_1_endpoints.html">Точки входа (endpoints)</a> — полный список URL</li> 
<li><a href="2_2_oauth.html">OAuth 2.0 авторизация</a> — scopes и детали токенов</li> 
<li><a href="12_1_integration_checklist.html">Чек-лист интеграции</a></li> 
<li><a href="16_1_postman_collection.html">Postman-коллекции</a></li> 
<li><a href="14_2_faq.html">FAQ</a></li> 
</ul>

Помогла эта информация?

Да Нет

Спасибо за отзыв

Отправить

1.3 Lamoda Seller Partner API vs Lamoda B2B Platform API

1.1 О Lamoda Seller AP