Шаблон для обращений по API

Чтобы мы могли быстро разобраться в проблеме, включите в обращение три блока: информацию о запросе, информацию об ответе и описание проблемы.

Важно: чем полнее заполнен шаблон, тем быстрее мы сможем помочь. Обращения без тела запроса или кода ответа обрабатываются дольше.

1. Информация о запросе

Что указать	Описание
Эндпоинт (URL)	Полный адрес, на который отправлялся запрос. Например: `https://api-b2b.lamoda.ruGET /api/v1/shipments/fulfilment`
Метод	HTTP-метод запроса: `GET`, `POST`, `PUT`, `DELETE`
Заголовки (Headers)	Передаваемые заголовки, включая `Authorization` (без самого токена — укажите `Bearer ***`), `Content-Type`, `X-Client-ID` и др.
Тело запроса (Body)	JSON-тело запроса для методов `POST` / `PUT` / `PATCH`

Пример curl-запроса:

curl -v -X POST https://api-b2b.lamoda.ru/api/v1/shipments/fulfilment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ***" \
  -H "X-Client-ID: 12345" \
  -d '{
    "order_id": "123456",
    "items": [{"sku": "ABC123", "quantity": 2}]
  }'

2. Информация об ответе

Что указать	Описание
HTTP-код ответа	Например: `200 OK`, `401 Unauthorized`, `500 Internal Server Error`
Заголовки ответа	Заголовки из ответа сервера, включая `Content-Type`, `X-Request-Id` (если есть)
Тело ответа (Body)	Полный JSON-ответ от сервера
Время выполнения	Сколько времени занял запрос (если актуально для проблемы)

Пример ответа с ошибкой:

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "status": "error",
  "message": "Invalid API key"
}

3. Описание проблемы

Кратко опишите, что пошло не так. Ниже — типовые категории.

Некорректный ответ

Тип	Что указать
Некорректный код ответа	Какой код ожидали и какой получили
Некорректная структура ответа	Какие поля отсутствуют или отличаются от документации
Содержимое не соответствует документации	Ссылка на раздел документации и описание расхождения

Таймаут

Что указать	Пример
Через какое время приходит ошибка	«Через 60 секунд получаю таймаут»
Воспроизводится ли с другой машины	Проверьте с рабочего компьютера с отключённым VPN

Пример заполненного обращения

Тема: Ошибка 401 при создании отгрузки FBS

Запрос:

POST https://api-b2b.lamoda.ru/api/v1/shipments/fulfilment
Content-Type: application/json
Authorization: Bearer ***

{
  "order_id": "123456",
  "items": [{"sku": "ABC123", "quantity": 2}]
}

Ответ:

HTTP 401 Unauthorized

{
  "status": "error",
  "message": "Invalid API key"
}

Проблема: Токен получен менее часа назад через POST /oauth/token. Ожидал 201 Created. Запрос воспроизводится стабильно с разных машин.

Куда отправлять

Заполненный шаблон отправляйте на api-integration@lamoda.ru.

См. также

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

Да Нет

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

0/1000 Отправить

О Lamoda API

Поддержка в API