Endi FoodSoul’ni istalgan tizimingizga ulash mumkin
Biz API uchun kirish tokenlarini qo‘shdik. Endi FoodSoul’ni to‘g‘ridan-to‘g‘ri hisob dasturingiz, 1C, ombor, analitika, bot yoki o‘z ishlab chiqilgan tizimingiz bilan bog‘lash mumkin. Ma’lumotlarni qo‘lda yuklab olish va ko‘chirish endi shart emas.
Avval faqat bizning ro‘yxatimizdagi tayyor integratsiyalarga ulanish mumkin edi. Endi esa o‘zingiz integratsiya qilishingiz mumkin.
API FoodSoul uchun kirish tokenlari nima uchun kerak?
Token yordamida CRM’ning aksariyat bo‘limlari bilan ishlash mumkin. Qaysi huquqlar integratsiyangizga ruxsat etilganligi esa token uchun tanlagan rolingizga bog‘liq.
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 hisob dasturi 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 huquqlarini oladi, lekin sizda mavjud bo‘lganidan ortig‘ini 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 biriktirilmagan 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 qayerdan o‘qish mumkin:
📖 WIKI’dagi sozlash bo‘yicha yo‘riqnoma: https://wiki.foodsoul.ru/ru/public/api
📄 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!