Integration API · Контент

Створити або оновити чернетку

PUThttps://{store}/api/v1/integrations/content/pages/{external_id}

Записує сторінку чи запис блогу за вашим id. Збереження не публікує: для цього є метод публікації. HTML у body очищується; адреса береться зі slug або із заголовка.

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

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

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

Ваш id сторінки.

Тіло запиту application/json

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

Заголовок.

typestring

page або blog. За замовчуванням page.

pageblog

slugstring

Частина адреси; без неї створюється із заголовка.

bodystring

HTML сторінки.

Приклад

{
    "type": "blog",
    "title": "Як обрати навушники",
    "slug": "yak-obraty-navushnyky",
    "body": "<p>Три речі, на які варто зважати…</p>"
}

Відповіді

200Чернетка.

{
    "external_id": "cms-post-118",
    "data": {
        "id": 58,
        "type": "blog",
        "title": "Як обрати навушники",
        "slug": "yak-obraty-navushnyky",
        "published_at": null,
        "updated_at": "2026-10-12 08:55:00"
    }
}

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

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

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

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

{ "external_id": "cms-post-118", "data": { "id": 58, "type": "blog", "title": "Як обрати навушники", "slug": "yak-obraty-navushnyky", "published_at": null, "updated_at": "2026-10-12 08:55:00" } }