
Важливо: інтеграції на User API перестануть працювати з 1 січня 2027 року
Ми відключаємо User API — старий API FoodSoul, через який раніше змінювали статуси замовлень, оновлювали ціни та райони доставки, керували кур'єрами. Він давно не оновлюється: всі нові можливості ми додаємо в CRM API.
Якщо ваша інтеграція працює через User API, її потрібно перевести на CRM API до 1 січня. Інакше після цієї дати FoodSoul відповідатиме помилкою на всі її запити. Як підготуватися до переходу, розповідаємо нижче.
Як перевірити інтеграцію
Перевірити, чи працює ваша інтеграція через User API, може розробник. Така інтеграція надсилає запити на адреси такого виду:
- https://foodsoul.ru/api/user/v1/ (а також by.) — перша версія;
- https://foodsoul.ru/api/user/v2/ (а також by.) — друга версія.
Якщо не впевнені, запитайте у того, хто обслуговує вашу інтеграцію, або напишіть у підтримку.
Що дає перехід
CRM API вміє значно більше, ніж User API: у ньому можна працювати із замовленнями та їх картками, меню, стоп-листом і залишками, клієнтами, акціями та звітами.
Окремо варто згадати про вебхуки. Завдяки їм CRM сама повідомляє вашу систему про події — наприклад, про нове замовлення чи зміну статусу, — і інтеграції не потрібно постійно опитувати API.
Ще одна перевага — окремі токени доступу. Кожній інтеграції можна видати свій токен із потрібними правами, а за потреби в будь-який момент заблокувати або видалити його.
Як перейти
- Створіть API-токен у CRM: “Інтеграції” → “Токени доступу до API”. Одразу збережіть його: токен показується лише один раз, під час створення.
- Передайте токен і посилання на документацію CRM API вашому розробнику.
- Розробник перенесе інтеграцію на CRM API. Однієї заміни адреси недостатньо: дію тепер вказують у URL запиту, а список полів, що передаються у запитах і відповідях, змінився.
Нагадуємо, що зробити це потрібно до 1 січня 2027 року.
Повна документація CRM API — на порталі FoodSoul: docs.foodsoul.ru. Якщо потрібна допомога з переходом, напишіть у підтримку.
З повагою, команда FoodSoul! Ми працюємо для Вас!