Endi FoodSoul’ni istalgan tizimingizga ulash mumkin

Biz API uchun kirish tokenlarini qo‘shdik. Bu shuni anglatadiki, FoodSoul’ni to‘g‘ridan-to‘g‘ri hisob dasturingiz, ombor, tahlil tizimi, bot yoki o‘z ishlab chiqishingiz bilan bog‘lash mumkin. Endi ma’lumotlarni qo‘lda yuklab olish va ko‘chirish shart emas.

Avval faqat bizning ro‘yxatimizdagi tayyor integratsiyalarga ulanish mumkin edi. Endi esa o‘zingizniki integratsiyani yaratishingiz mumkin.

FoodSoul API uchun kirish tokenlari nima uchun kerak?

Token yordamida CRM’ning aksariyat bo‘limlari bilan ishlash mumkin. Qaysi huquqlar integratsiyangizga ruxsat etilganini esa token uchun tanlagan rolingiz belgilaydi.

Masalan, “Operator” roli bilan yaratilgan token quyidagi huquqlarga ega bo‘ladi:

✅ Mumkin: mahsulotlar, toifalar, stop-listlar, ombordagi qoldiqlar, buyurtmalar, sharhlar va manzillarni o‘zgartirish, to‘lovlar bilan ishlash.
❌ Mumkin emas: buxgalteriya hisobotlari va kontragentlarni ko‘rish.

Bunday token, masalan, ombor hisobini yurituvchi dastur uchun mos keladi — u qoldiqlar va stop-listlarni o‘zi yangilaydi. Har bir integratsiya uchun faqat kerakli huquqlarga ega rolni tanlang: tokenning huquqlari qancha kam bo‘lsa, shuncha xavfsiz bo‘ladi.

Hamkorlik dasturi ishtirokchilari uchun alohida so‘rovlar mavjud: ulangan kompaniyalar, hisobotlar va mablag‘larni chiqarish.

Qanday ulanish mumkin?

1. CRM’da “API uchun kirish tokenlari” bo‘limini oching va token yarating. Token — bu sizning tizimingiz FoodSoul’ga kirishi uchun kalit. Unga xodimning login yoki paroli kerak emas.

2. Token uchun rol tanlang. Token ushbu rolning huquqlariga ega bo‘ladi, lekin sizda mavjud bo‘lganidan ortig‘iga emas.

3. Zarur bo‘lsa, cheklovlarni belgilang:

• faqat bitta tarmoq yoki akkauntdagi barcha tarmoqlarga kirish;
• amal qilish muddati: vaqtinchalik yoki doimiy;
• so‘rovlar ruxsat etilgan IP-manzillar ro‘yxati. Boshqa manzillardan so‘rovlar rad etiladi.

4. Tokenni tizimingizdagi har bir so‘rovga qo‘shing:
Authorization: Bearer fs_api_...
Agar token bitta tarmoqqa bog‘lanmagan bo‘lsa, kerakli tarmoqni sarlavhada ko‘rsating:
Chain: chain_id

Token sozlamalarini istalgan vaqtda o‘zgartirish mumkin, tokenning o‘zi esa o‘zgarmaydi. Uni bloklash, blokdan chiqarish yoki o‘chirish ham mumkin.

❗️ Xavfsizlik haqida muhim

• To‘liq token faqat bir marta, yaratilganda ko‘rsatiladi. Uni darhol saqlab qo‘ying. Biz tokenni shifrlangan holda saqlaymiz va uni tiklash imkoni yo‘q, shuning uchun yo‘qolgan tokenni qaytarib bo‘lmaydi. Yangi token yaratib, uni integratsiyaga almashtirishga to‘g‘ri keladi.
• Har bir integratsiya uchun alohida token yarating. Shunda kerak bo‘lsa, bir integratsiyani o‘chirib, boshqalari ishlashda davom etadi.

Batafsil ma’lumot qayerda:

📄 Barcha metodlar tavsifi (OpenAPI spetsifikatsiyasi)ni texnik yordamdan so‘rashingiz mumkin. Tez orada ishlab chiquvchilar portali ham paydo bo‘ladi.

 
Hurmat bilan, FoodSoul jamoasi! Biz siz uchun ishlaymiz!