Содержание статьи
7.2 Получение списка заказов
Метод возвращает список заказов с возможностью фильтрации по статусу, дате и другим параметрам.
Базовый запрос
curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders?limit=100" \
-H "Authorization: Bearer YOUR_TOKEN"
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
limit
|
integer | Нет | Количество записей на странице (по умолчанию 25) |
page
|
integer | Нет | Номер страницы (по умолчанию 1) |
filter
|
string | Нет | Строка фильтрации (см. раздел "Фильтрация" ниже) |
sort
|
string | Нет | Сортировка результатов |
Фильтрация
⚠️ Важно: Параметр
filter использует специальный синтаксис с операторами. Значения передаются в едином параметре, а не как отдельные query-параметры.
Синтаксис фильтрации
Формат: filter=поле{оператор}значение
| Оператор | Описание | Пример |
=
|
Равно |
filter=status=confirmed
|
>=
|
Больше или равно |
filter=updatedAt>=20250101000000
|
<=
|
Меньше или равно |
filter=createdAt<=20250131235959
|
>=<
|
Диапазон (от, до) |
filter=updatedAt>=<20250101000000,20250131235959
|
Поддерживаемые поля для фильтрации
| Поле | Тип | Описание |
status
|
string | Статус заказа (confirmed, shipped, delivered, cancelled и др.) |
createdAt
|
datetime |
Дата создания заказа. Формат: YYYYMMDDHHmmss
|
updatedAt
|
datetime |
Дата обновления заказа. Формат: YYYYMMDDHHmmss
|
deliveryDate
|
date | Дата доставки |
fullSearch
|
string | Поиск по номеру заказа, фамилии, телефону или email клиента |
isOverdue
|
boolean | Только просроченные заказы (cutOff < текущее время) |
Примеры запросов
Получить заказы, готовые к сборке
GET /api/v1/orders?filter=status=confirmed&limit=100
Получить заказы за период (диапазон дат)
# Заказы, обновлённые с 1 по 31 января 2025
GET /api/v1/orders?filter=updatedAt%3E%3D%3C20250101000000,20250131235959
# URL-decoded версия для понимания:
# filter=updatedAt>=<20250101000000,20250131235959
Помогла эта информация?
Спасибо за отзыв