Довідка Hosturm як керувати своїм магазином

API для програмістів

Якщо у вас є розробник або товарна програма — магазин можна оновлювати автоматично.

До магазину відкритий програмний доступ: товари, ціни, залишки, замовлення, клієнти, сторінки й вигляд вітрини. Це знімає ручну роботу, коли позицій багато або склад живе в іншій системі.

Що можна автоматизувати

Вигляд вітрини — теж через API

Тема (світла / темна / як у системі) і варіант оформлення читаються й міняються одним запитом:

GET  /v1/theme              → {"default_theme":"auto","preset":"classic", ...}
PUT  /v1/theme               {"preset":"bright"}

Допустимі варіанти оформлення: classic, strict, bright — це ті самі три, що в панелі (Вигляд сайту).

Методи PUT, PATCH і DELETE працюють напряму. Якщо ваша програма вміє лише GET і POST — надсилайте POST з ?_method=PUT, результат той самий.

Як почати

API входить у тариф «Максимум». Ключ приходить листом після запуску, а також видається в кабінеті: my.hosturm.com → «Мій магазин» → «Видати ключ API». Ключ передається в заголовку Authorization: Bearer ваш_ключ. Документація з прикладами — api.hosturm.com/docs. Передайте цю адресу своєму програмісту, там усе описано.

Ключ — це доступ до вашого магазину. Не публікуйте його й не надсилайте в спільні чати. Якщо він засвітився — видайте новий у кабінеті: старий одразу перестане працювати. Або напишіть нам, вимкнемо старий і видамо новий за хвилину.

Чого API не робить

Ключ не дає доступу до файлів магазину, бази даних чи панелі хостингу. Це навмисно: так ваш магазин не зламають через чужу інтеграцію.

Не знайшли відповідь? Напишіть нам — відповімо й доповнимо довідку.
Магазин працює на Hosturm · hosturm.com