Integration API · Синхронізація каталогу

Створити або перейменувати категорію

PUThttps://{store}/api/v1/integrations/catalog/categories/{external_id}

Створює категорію під час першого виклику й перейменовує її під час наступних. Товари прив’язуються до неї через category_external_ids.

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

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

external_idstringобов'язковий

Ваш id категорії.

namestringобов'язкове

Назва категорії.

{
    "name": "Аудіо"
}

200Категорія.

{
    "external_id": "erp-cat-audio",
    "data": {
        "id": 7,
        "name": "Аудіо"
    }
}

401Ключа немає, він невідомий або відкликаний.

{
    "code": "unauthenticated",
    "message": "Integration key is inactive.",
    "field": null
}

403У ключа немає права catalog:write, або тариф магазину без доступу до API.

{
    "code": "forbidden",
    "message": "Integration key cannot catalog:write.",
    "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
}