Часто шукають

↑↓ вибрати ↵ відкрити Усі результати →

Integration API · Товари

Список товарів

GEThttps://{store}/api/v1/integrations/products

Сторінка каталогу в порядку id. Сторінки — через page і limit, звуження — filter[name] або filter[sku]. Додайте include=offers, щоб отримати варіанти з артикулом, ціною й залишком.

Ключ інтеграції з правом catalog:read: Authorization: Bearer {key}.

Параметри запиту

pageinteger
Номер сторінки, від 1.
limitinteger
Розмір сторінки: за замовчуванням 15, максимум 50.
filter[name]string
Частина назви товару.
filter[sku]string
Точний артикул варіанта.
includestring
offers додає варіанти до кожного товару.
offers

Відповіді

200Сторінка товарів. 
{
    "current_page": 1,
    "data": [
        {
            "id": 12,
            "name": "Навушники Sonar ANC повнорозмірні",
            "description": "Активне шумозаглушення, 40 годин роботи.",
            "sku": "SONAR-ANC-BLK",
            "thumbnail_url": "https://your-store.storeforma.shop/media/12/sonar-anc.webp",
            "quantity": 24,
            "currency_code": "UAH",
            "min_price": 599900,
            "max_price": 599900,
            "weight": 0.32,
            "length": null,
            "height": null,
            "width": null,
            "has_offers": false,
            "is_archived": false,
            "category_id": 7,
            "attributes": [
                {
                    "handle": "kolir",
                    "name": "Колір",
                    "type": "swatch",
                    "unit": null,
                    "group": null,
                    "variant_axis": false,
                    "values": [
                        "Чорний"
                    ]
                },
                {
                    "handle": "vaga",
                    "name": "Вага",
                    "type": "number",
                    "unit": "г",
                    "group": "Загальні",
                    "variant_axis": false,
                    "values": [
                        "320 г"
                    ]
                }
            ],
            "input_options": [
                {
                    "key": "hraviiuvannia",
                    "label": "Гравіювання",
                    "type": "text",
                    "required": false,
                    "price": 10000,
                    "max": 30,
                    "choices": []
                }
            ],
            "created_at": "2026-10-01 10:12:00",
            "updated_at": "2026-10-12 08:40:00",
            "offers": [
                {
                    "id": 15,
                    "sku": "SONAR-ANC-BLK",
                    "price": 599900,
                    "quantity": 24,
                    "properties": [
                        {
                            "name": "Колір",
                            "value": "Чорний"
                        }
                    ]
                }
            ]
        }
    ],
    "from": 1,
    "last_page": 1,
    "per_page": 15,
    "to": 1,
    "total": 1,
    "path": "https://your-store.storeforma.shop/api/v1/integrations/products",
    "next_page_url": null,
    "prev_page_url": null
}
401Ключа немає, він невідомий або відкликаний. 
{
    "code": "unauthenticated",
    "message": "Integration key is inactive.",
    "field": null
}
403У ключа немає права catalog:read, або тариф магазину без доступу до API. 
{
    "code": "forbidden",
    "message": "Integration key cannot catalog:read.",
    "field": null
}
422Поле має помилку; його назва — у field. 
{
    "code": "validation_error",
    "message": "name is required.",
    "field": "name"
}
429Понад 60 запитів за хвилину для цього ключа. Зачекайте Retry-After секунд. 
{
    "code": "rate_limited",
    "message": "Too many integration requests.",
    "field": null
}