Точки входа API

Новость на модерации

Обновлено

10.12.2025

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

Lamoda предоставляет два окружения для интеграции: тестовое (Demo) и боевое (Prod). Каждое окружение имеет собственные точки входа для API и веб-интерфейса. 
 
 
<h2>Окружения API</h2> 
 
<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;">Base URL</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Demo</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тестирование интеграции, отладка</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-demo-b2b.lamoda.ru">https://api-demo-b2b.lamoda.ru</a></code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Prod</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Боевая работа с реальными данными</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru">https://api-b2b.lamoda.ru</a></code></td> 
</tr> 
</tbody> 
</table> 
 
<h2>B2B Platform API (REST)</h2> 
 
Основной REST API для работы с заказами, отгрузками, поставками, остатками. 
 
<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;">Endpoint</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Demo</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-demo-b2b.lamoda.ru/api/v1/">https://api-demo-b2b.lamoda.ru/api/v1/</a></code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Prod</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/">https://api-b2b.lamoda.ru/api/v1/</a></code></td> 
</tr> 
</tbody> 
</table> 
 
<h3>Пример запроса к Prod API</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/orders?limit=10">https://api-b2b.lamoda.ru/api/v1/orders?limit=10</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ 
 -H "Content-Type: application/json" 
</pre> 
 
<h3>Пример запроса к Demo API</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-demo-b2b.lamoda.ru/api/v1/orders?limit=10">https://api-demo-b2b.lamoda.ru/api/v1/orders?limit=10</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ 
 -H "Content-Type: application/json" 
</pre> 
 
<h2>Seller API (JSON-RPC)</h2> 
 
JSON-RPC API для работы с номенклатурой, ценами, атрибутами. 
 
<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;">Endpoint</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Demo</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-demo-seller.lamoda.ru/jsonrpc">https://api-demo-seller.lamoda.ru/jsonrpc</a></code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Prod</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://public-api-seller.lamoda.ru/jsonrpc/jsonrpc">https://public-api-seller.lamoda.ru/jsonrpc/jsonrpc</a></code></td> 
</tr> 
</tbody> 
</table> 
 
<h3>Пример JSON-RPC запроса</h3> 
 
<pre> 
curl -X POST "<a class="txttohtmllink" href="https://public-api-seller.lamoda.ru/jsonrpc/jsonrpc">https://public-api-seller.lamoda.ru/jsonrpc/jsonrpc</a>" \ 
 -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 
 } 
 }' 
</pre> 
 
<h2>Авторизация (OAuth2)</h2> 
 
<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;">Token Endpoint</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Demo</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-demo-b2b.lamoda.ru/auth/token">https://api-demo-b2b.lamoda.ru/auth/token</a></code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Prod</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru/auth/token">https://api-b2b.lamoda.ru/auth/token</a></code></td> 
</tr> 
</tbody> 
</table> 
 
<h3>Получение токена</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/auth/token?client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials">https://api-b2b.lamoda.ru/auth/token?client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials</a>" 
</pre> 
 
 Важно: Время жизни токена (TTL) — 15 минут. Обновляйте токен до истечения срока действия. 
<h2>Веб-интерфейс (Личный кабинет)</h2> 
 
<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;">URL</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Назначение</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Demo</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://demo-b2b.lamoda.ru">https://demo-b2b.lamoda.ru</a></code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Ознакомление с интерфейсом, тестирование</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Prod</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://partner.lamoda.ru">https://partner.lamoda.ru</a></code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Работа с реальными данными</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Этапы интеграции</h2> 
 
<ol> 
<li> 
Получение credentials 
Запросите у sales-manager ключи <code>client_id</code> и <code>client_secret</code> для Demo и Prod окружений. 
</li> 
<li> 
Тестирование на Demo 
Разработка и отладка интеграции на <code><a class="txttohtmllink" href="https://api-demo-b2b.lamoda.ru">https://api-demo-b2b.lamoda.ru</a></code>. Данные в Demo окружении тестовые. 
</li> 
<li> 
Стабилизация на Prod 
Переключение на <code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru">https://api-b2b.lamoda.ru</a></code>. Работа с реальными заказами и товарами. 
</li> 
</ol> 
 
<h2>Переключение между окружениями</h2> 
 
При переходе с Demo на Prod необходимо: 
 
 Чек-лист перехода на Prod: 
<ul> 
<li>Заменить base URL с <code>api-demo-b2b</code> на <code>api-b2b</code></li> 
<li>Использовать Prod credentials (они отличаются от Demo)</li> 
<li>Убедиться, что SKU товаров совпадают с реальными артикулами</li> 
<li>Предоставить боевой URL для нотификаций</li> 
<li>Включить логирование всех запросов и ответов</li> 
</ul> 
 Частые ошибки: 
<ul> 
<li>Использование Demo credentials на Prod</li> 
<li>URL содержит "demo" в production-коде</li> 
<li>Несоответствие SKU между системами</li> 
<li>Отсутствие обработки ошибок авторизации</li> 
</ul> 
<h2>Требования к запросам</h2> 
 
<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> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Протокол</td> 
<td style="border: 1px solid #ddd; padding: 8px;">HTTPS (обязательно)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Content-Type</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>application/json</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Authorization</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Bearer {access_token}</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Формат данных</td> 
<td style="border: 1px solid #ddd; padding: 8px;">JSON (RFC 4627)</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Логирование</h2> 
 
Для быстрой диагностики проблем логируйте: 
 
<ul> 
<li>Время запроса</li> 
<li>HTTP-метод и полный URL с query-параметрами</li> 
<li>Заголовки запроса</li> 
<li>Тело запроса (для POST/PUT/PATCH)</li> 
<li>Код ответа HTTP</li> 
<li>Тело ответа</li> 
<li>Время выполнения запроса</li> 
</ul> 
 
<h3>Пример структуры лога</h3> 
 
<pre> 
{ 
 "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": "CZ123456789"}, 
 "duration_ms": 245 
 } 
} 
</pre> 
 
<h2>API Specification</h2> 
 
Актуальная спецификация API доступна: 
 
<ul> 
<li>B2B Platform API: <a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/">https://academy.lamoda.ru/articles/api/apispec/</a>">OpenAPI Specification</a></li> 
<li>Seller API: <a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec2/lamoda-seller-partner-api/">https://academy.lamoda.ru/articles/api/apispec2/lamoda-seller-partner-api/</a>">Lamoda Seller Partner API</a></li> 
</ul> 
 
<h2>Обратная совместимость</h2> 
 
 Важно: JSON-формат подразумевает возможность добавления новых полей в ответы API без предупреждения. Это обратносовместимая операция. Убедитесь, что ваш парсер игнорирует неизвестные поля. 
<h2>См. также</h2> 
 
<ul> 
<li><a href="2_2_oauth.html">OAuth 2.0 авторизация</a></li> 
<li><a href="1_2_quickstart.html">Быстрый старт</a></li> 
<li><a href="12_1_integration_checklist.html">Чек-лист интеграции</a></li> 
</ul>

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

Да Нет

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

Отправить

Новогодний бонус на рекламное продвижение

Seller Partner API vs B2B Platform API