Тепер FoodSoul можна підключити до будь-якої вашої системи

Ми додали токени доступу до API. Це означає, що FoodSoul можна напряму підключити до вашої облікової програми, 1С, складу, аналітики, бота чи власної розробки. Більше не потрібно вручну вивантажувати та переносити дані.

Раніше підключитися можна було лише до готових інтеграцій із нашого списку. Тепер ви можете створити власну.

Для чого потрібні токени доступу до API FoodSoul?

За допомогою токена можна працювати з більшістю розділів CRM. А які саме доступи дозволені вашій інтеграції, залежить від ролі, яку ви оберете для токена.

Наприклад, у токена з роллю “Оператор” будуть такі права:

✅ Можна: змінювати товари, категорії, стоп-листи, складські залишки, замовлення, відгуки та адреси, працювати з платежами.
❌ Не можна: переглядати бухгалтерські звіти та контрагентів.

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

Для учасників партнерської програми є окремі запити: підключені компанії, звіти та виведення коштів.

Як підключитися?

1. У CRM відкрийте розділ “Токени доступу до API” та створіть токен. Токен — це ключ, за яким ваша система буде заходити у FoodSoul. Їй не потрібні ні логін, ні пароль співробітника.

2. Оберіть для токена роль. Токен отримає права цієї ролі, але не більше, ніж є у вас самих.

3. За потреби задайте обмеження:

• доступ лише до однієї мережі або до всіх мереж акаунта;
• строк дії: тимчасовий або безстроковий;
• список IP-адрес, з яких дозволені запити. З інших адрес запити будуть відхилятися.

4. Додайте токен у кожен запит вашої системи:
Authorization: Bearer fs_api_...
Якщо токен не прив’язаний до однієї мережі, вкажіть потрібну у заголовку:
Chain: chain_id

Налаштування токена можна змінювати у будь-який момент, сам токен при цьому залишається тим самим. Його також можна заблокувати, розблокувати або видалити.

❗️ Важливо про безпеку

• Повний токен показується лише один раз, під час створення. Одразу збережіть його. Ми зберігаємо токен у зашифрованому вигляді без можливості відновлення, тому втрачений токен повернути не можна. Доведеться створити новий і замінити його в інтеграції.
• Для кожної інтеграції створюйте окремий токен. Тоді за потреби ви зможете відключити одну інтеграцію, а решта продовжать працювати.

Де почитати докладніше:

📖 Інструкція з налаштування у WIKI: https://wiki.foodsoul.ru/ru/public/api
📄 Опис усіх методів (специфікацію OpenAPI) можна запросити у технічній підтримці. Незабаром з’явиться портал розробника.

З повагою, команда FoodSoul! Ми працюємо для Вас!