API: товары и варианты
Обновлено: 16.06.2026
Эндпоинты возвращают каталог товаров и их вариантов. Требуется разрешение products:read.
GET /api/v1/products
Возвращает товары с вложенными вариантами и штрихкодами.
| Параметр | Тип | Описание |
|---|---|---|
search |
string | Поиск по названию/артикулу |
status |
string | Фильтр по статусу товара |
page / per_page |
integer | Пагинация (макс. 200) |
json
{
"data": [
{
"id": "01J...",
"number": "P-001",
"sku": "ART-001",
"title": "Футболка белая",
"brand": "Acme",
"color": "белый",
"status": "active",
"variants": [
{
"id": "01J...",
"product_id": "01J...",
"number": "P-001-1",
"title": "XL",
"size_ru": "54",
"price": 1990.0,
"barcodes": ["2000000000017"]
}
]
}
],
"meta": { "current_page": 1, "per_page": 50, "total": 1, "last_page": 1 }
}GET /api/v1/variants
Возвращает плоский список вариантов. Поддерживает фильтр product_id и пагинацию.
json
{
"data": [
{
"id": "01J...",
"product_id": "01J...",
"number": "P-001-1",
"title": "XL",
"size_ru": "54",
"price": 1990.0,
"barcodes": ["2000000000017"]
}
],
"meta": { "current_page": 1, "per_page": 50, "total": 1, "last_page": 1 }
}