Енді FoodSoul-ды кез келген жүйеңізге қосуға болады

Біз API-ге қол жеткізу токендерін қостық. Бұл FoodSoul-ды тікелей сіздің есептік бағдарламаңызбен, қоймаңызбен, аналитикамен, ботпен немесе өзіңіздің әзірлемеңізбен байланыстыруға болады деген сөз. Енді деректерді қолмен жүктеп, тасымалдаудың қажеті жоқ.

Бұрын тек біздің тізімдегі дайын интеграцияларға ғана қосылуға болатын. Енді өз интеграцияңызды жасай аласыз.

FoodSoul API-ге қол жеткізу токендері не үшін қажет?

Токен арқылы CRM-нің көптеген бөлімдерімен жұмыс істеуге болады. Ал интеграцияңызға қандай рұқсаттар берілетіні, токенге таңдаған рөліңізге байланысты.

Мысалы, “Оператор” рөлі бар токеннің құқықтары мынадай болады:

✅ Мүмкін: тауарларды, санаттарды, стоп-листтерді, қойма қалдықтарын, тапсырыстарды, пікірлер мен мекенжайларды өзгерту, төлемдермен жұмыс істеу.
❌ Мүмкін емес: бухгалтерлік есептер мен контрагенттерді көру.

Мұндай токен, мысалы, қойма есебінің бағдарламасына жарайды, ол қалдықтар мен стоп-листтерді өзі жаңартады. Әр интеграция үшін тек қажетті құқықтары бар рөлді таңдаңыз: токеннің құқықтары неғұрлым аз болса, соғұрлым қауіпсіз.

Серіктестік бағдарлама қатысушылары үшін бөлек сұраныстар бар: қосылған компаниялар, есептер және қаражат шығару.

Қалай қосылуға болады?

1. CRM-де “API-ге қол жеткізу токендері” бөлімін ашып, токен жасаңыз. Токен — бұл сіздің жүйеңіздің FoodSoul-ға кіру кілті. Оған қызметкердің логині де, құпиясөзі де қажет емес.

2. Токенге рөл таңдаңыз. Токен осы рөлдің құқықтарын алады, бірақ сіздің өзіңізде бар құқықтардан артық емес.

3. Қажет болса, шектеулер қойыңыз:

• тек бір желіге немесе аккаунттағы барлық желілерге қол жеткізу;
• жарамдылық мерзімі: уақытша немесе мерзімсіз;
• рұқсат етілген сұраныстардың IP-мекенжайларының тізімі. Басқа мекенжайлардан сұраныстар қабылданбайды.

4. Жүйеңіздің әр сұранысына токенді қосыңыз:
Authorization: Bearer fs_api_...
Егер токен бір желіге байланбаған болса, қажетті желіні тақырыпта көрсетіңіз:
Chain: chain_id

Токеннің баптауларын кез келген уақытта өзгертуге болады, токеннің өзі өзгермейді. Сондай-ақ оны бұғаттауға, бұғаттан шығаруға немесе өшіруге болады.

❗️ Қауіпсіздік туралы маңызды

• Толық токен тек бір рет, жасалған кезде ғана көрсетіледі. Оны бірден сақтап алыңыз. Біз токенді шифрланған түрде сақтаймыз және оны қалпына келтіру мүмкін емес, сондықтан жоғалған токенді қайтару мүмкін емес. Жаңа токен жасап, оны интеграцияда ауыстыру қажет болады.
• Әр интеграция үшін жеке токен жасаңыз. Сонда қажет болған жағдайда бір интеграцияны өшіріп, қалғандары жұмысын жалғастырады.

Қайдан толық оқуға болады:

📄 Барлық әдістердің сипаттамасын (OpenAPI спецификациясын) техникалық қолдау қызметінен сұрауға болады. Жақында әзірлеуші порталы ашылады.

 
Құрметпен, FoodSoul командасы! Біз сіз үшін жұмыс істейміз!