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

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

Обновлено

18.12.2025

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

Lamoda использует OAuth 2.0 с типом гранта <code>client_credentials</code>. Для доступа к API необходимо получить токен и передавать его в заголовке каждого запроса. 
 
 Важно: единые credentials, единый TTL 
<ul> 
<li>Один набор <code>client_id</code> / <code>client_secret</code> для обоих API</li> 
<li>Время жизни токена: 15 минут (900 секунд) для обоих API</li> 
<li>Endpoints авторизации разные для каждого API</li> 
</ul> 
<h2>Endpoints авторизации</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Endpoint</td> 
<td style="border: 1px solid #ddd; padding: 8px;">TTL токена</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Seller API</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://public-api-seller.lamoda.ru/jsonrpc">https://public-api-seller.lamoda.ru/jsonrpc</a></code> метод: <code>v1.tokens.create</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">15 минут</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">B2B Platform API</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> 
<td style="border: 1px solid #ddd; padding: 8px;">15 минут</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Получение токена</h2> 
 
<h3>Seller API (JSON-RPC)</h3> 
 
<pre><code>curl -X POST <a class="txttohtmllink" href="https://public-api-seller.lamoda.ru/jsonrpc">https://public-api-seller.lamoda.ru/jsonrpc</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> 
 
Успешный ответ Seller API: 
 
<pre><code>{ 
 "jsonrpc": "2.0", 
 "id": "550e8400-e29b-41d4-a716-446655440000", 
 "result": { 
 "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", 
 "token_type": "bearer", 
 "expires_in": 900 
 } 
}</code></pre> 
 
<h3>B2B Platform API (REST)</h3> 
 
<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> 
 
Успешный ответ B2B API: 
 
<pre><code>{ 
 "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", 
 "token_type": "Bearer", 
 "expires_in": 900 
}</code></pre> 
 
<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> 
</tbody> 
</table> 
 
 TTL = 15 минут! 
Токен живёт только 15 минут. Если ваша интеграция выполняет длительные операции (загрузка большого каталога, batch-обновление цен), необходимо: 
<ul> 
<li>Обновлять токен заранее (за 1-2 минуты до истечения)</li> 
<li>Или запрашивать новый токен при получении ошибки <code>401 Unauthorized</code></li> 
</ul> 
<h2>Использование токена</h2> 
 
Передавайте токен в заголовке <code>Authorization</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> 
 
<h2>Стратегии обновления токена</h2> 
 
<h3>Вариант 1: Проактивное обновление (рекомендуется)</h3> 
 
Обновляйте токен за 1-2 минуты до истечения: 
 
<pre><code>import time 
import requests 
 
class LamodaAPI: 
 def __init__(self, client_id, client_secret, base_url): 
 self.client_id = client_id 
 self.client_secret = client_secret 
 self.base_url = base_url 
 self.token = None 
 self.token_expires_at = 0 
 
 def get_token(self): 
 # Обновляем токен за 60 секунд до истечения 
 if self.token and time.time() < self.token_expires_at - 60: 
 return self.token 
 
 response = requests.post( 
 f"{self.base_url}/auth/token", 
 json={ 
 "client_id": self.client_id, 
 "client_secret": self.client_secret, 
 "grant_type": "client_credentials" 
 } 
 ) 
 data = response.json() 
 
 self.token = data["access_token"] 
 self.token_expires_at = time.time() + data["expires_in"] 
 
 return self.token 
 
 def request(self, method, endpoint, **kwargs): 
 headers = kwargs.pop("headers", {}) 
 headers["Authorization"] = f"Bearer {self.get_token()}" 
 
 return requests.request( 
 method, 
 f"{self.base_url}{endpoint}", 
 headers=headers, 
 **kwargs 
)</code></pre> 
 
<h3>Вариант 2: Реактивное обновление</h3> 
 
При получении <code>401 Unauthorized</code> — запросите новый токен и повторите запрос: 
 
<pre><code>def request_with_retry(api, method, endpoint, data=None): 
 try: 
 return api.request(method, endpoint, json=data) 
 except requests.HTTPError as e: 
 if e.response.status_code == 401: 
 # Сбрасываем токен и пробуем снова 
 api.token = None 
 return api.request(method, endpoint, json=data) 
raise</code></pre> 
 
<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> 
<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>50401</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Unauthorized</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>50400</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Партнер не найден / Partner not found</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Неверный <code>client_id</code> или <code>client_secret</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Проверьте учётные данные у менеджера</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>50403</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Forbidden</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет прав на ресурс</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Проверьте права доступа у менеджера</td> 
</tr> 
</tbody> 
</table> 
 
Полный список ошибок: <a href="17_2_error_codes.html">Справочник кодов ошибок</a> 
 
<h2>Частые проблемы</h2> 
 
 "Партнер не найден" (50400) 
Причины: 
<ul> 
<li>Неверный <code>client_id</code> или <code>client_secret</code></li> 
<li>Партнёр не активирован в системе</li> 
</ul> 
Решение: Уточните credentials у вашего менеджера Lamoda 
 Токен перестаёт работать через 15 минут 
Это нормальное поведение! TTL токена = 900 секунд = 15 минут. 
Реализуйте автоматическое обновление токена (см. примеры выше). 
<h2>См. также</h2> 
 
<ul> 
<li><a href="1_4_auth_errors.html">Типичные ошибки авторизации</a></li> 
<li><a href="17_2_error_codes.html">Справочник кодов ошибок</a></li> 
<li><a href="16_1_postman_collection.html">Postman-коллекции</a></li> 
</ul>

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

Да Нет

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

Отправить

Атрибуты и справочники

Seller Partner API vs B2B