Енді 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 командасы! Біз сіз үшін жұмыс істейміз!