API Хорошопу: що це, як дати доступ і що можна підключити до магазину

Що таке API Хорошопу

Сайт на Хорошопі зберігає товари, ціни, наявність, характеристики й замовлення. Людина бачить це в адмінці, а програма — через API: вона надсилає запит на адресу вашого сайту й отримує дані у форматі, який легко обробити (JSON).

Тому, коли сервіс просить «доступ до API Хорошопу», він просить не пароль від адмінки, а логін і пароль API-користувача — з тими правами, які ви йому дасте.

Що можна робити через API

Найчастіші задачі й функції, які для них використовують:

Повний перелік функцій і параметрів — у документації API на порталі підтримки Хорошопу (відкривається після входу). Якщо сервіс просить права, яких його задача не потребує, — це привід перепитати.

Як дати доступ стороннім сервісам

1. Перевірте, чи є API на вашому тарифі. Якщо ні — його вмикають разом з тарифом з інтеграціями; деталі — у підтримці Хорошопу.
2. В адмінці відкрийте «Налаштування → Адміністратори» (у деяких версіях — «Користувачі») і створіть нового користувача з доступом до API.
3. Назвіть його за сервісом — наприклад, vybir чи crm: так завжди видно, хто має доступ.
4. Дайте мінімальні права. Сервісу для пошуку чи фідів досить читання каталогу; замовлення — лише якщо без них задача не працює; запис у каталог — лише тим, хто справді змінює товари.
5. Логін і пароль вводьте в кабінеті самого сервісу, а не пересилайте в месенджері.
6. Перестали користуватись сервісом — видаліть його користувача: доступ зникне одразу.

Як влаштований запит (для розробника)

Запити — POST з тілом у JSON на адресу https://ваш-домен/api/назва-функції/. Спершу — вхід логіном і паролем API-користувача, далі токен передається в кожному запиті:

POST https://shop.example/api/auth/
{"login": "vybir", "password": "…"}
→ {"status": "OK", "response": {"token": "…"}}

POST https://shop.example/api/catalog/export/
{"token": "…", "offset": 0, "limit": 500,
 "includedParams": ["title", "price", "presence", "link"]}
→ {"status": "OK", "response": {"products": [ … ]}}

Що варто знати з практики:

• Токен тимчасовий — у нашій роботі він діє близько 10 хвилин. На відповідь UNAUTHORIZED досить увійти ще раз.
• Великий каталог — сторінками: offset і limit. Статус EMPTY означає, що товарів далі немає.
• Лише потрібні поля: includedParams — вивантаження швидше й легше.
• Забагато запитів — HTTP_ERROR з кодом 429: зробіть паузу й повторіть.

Типові проблеми й що з ними робити

• Відповідь 403 на будь-який запит. Часто це не сам API, а захист сайту, який блокує запити від серверів. Перевірте налаштування захисту чи фаєрволу або напишіть у підтримку Хорошопу.
• Каталог вивантажується, а замовлення — ні. У API-користувача немає прав на замовлення. Додайте їх, якщо сервісу вони справді потрібні.
• Помилка з текстом про базу даних (на кшталт «Connection timed out»). Це тимчасовий збій на боці платформи — повторіть пізніше.
• Неправильний логін чи пароль. Пароль API-користувача — не той, що в головного адміністратора. Перевірте, якого користувача ви створили.

Безпека: на що дивитися

• Окремий користувач для кожного сервісу — щоб відкликати доступ одному, не чіпаючи інших.
• Лише читання, якщо сервіс нічого не змінює на сайті.
• Замовлення — лише за потреби: у них можуть бути імена, телефони й адреси покупців.
• Раз на кілька місяців перегляньте список користувачів і приберіть зайвих.

Що підключають до Хорошопу через API

• Маркетплейси й реклама — фіди для Rozetka, Prom, Google Merchant і Meta з актуальними цінами й наявністю.
• CRM і облік — замовлення потрапляють у CRM, ціни й залишки повертаються на сайт.
• Розсилки — сервіси листів і повідомлень беруть товари й замовлення для тригерних розсилок.
• AI-консультант і розумний пошук — читають каталог, щоб радити покупцям товари й знаходити їх за запитами з помилками.

Так працює й Вибір для Хорошопу: AI-консультант, пошук і допродаж читають лише каталог — товари, ціни й наявність — і нічого на сайті не змінюють. Замовлення — тільки якщо ви дозволите, і лише номер та рядки товарів, без даних покупців.