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

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

Integration API · Товари

Один товар

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

Товар за його id у цьому магазині. include=offers додає варіанти.

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

Параметри шляху

idintegerобов'язковий
Id товару в цьому магазині.

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

includestring
offers додає варіанти.
offers

Відповіді

200Товар. 
{
    "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": "Чорний"
                    }
                ]
            }
        ]
    }
}
404Товару з таким id немає. 
{
    "code": "not_found",
    "message": "not_found",
    "field": 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
}