
Vacibdir: User API üzərindən inteqrasiyalar 1 yanvar 2027-ci ildən etibarən işləməyəcək
Biz User API-ni — əvvəllər sifarişlərin statusunu dəyişmək, qiymətləri və çatdırılma rayonlarını yeniləmək, kuryerləri idarə etmək üçün istifadə olunan köhnə FoodSoul API-ni deaktiv edirik. Bu API artıq uzun müddətdir yenilənmir: bütün yeni imkanları biz CRM API-yə əlavə edirik.
Əgər inteqrasiyanız User API vasitəsilə işləyirsə, onu 1 yanvar tarixinədək CRM API-yə keçirməlisiniz. Əks halda, bu tarixdən sonra FoodSoul həmin sorğulara səhv cavabı verəcək. Keçidə necə hazırlaşmaq barədə aşağıda danışırıq.
İnteqrasiyanı necə yoxlamaq olar
İnteqrasiyanızın User API vasitəsilə işləyib-işləmədiyini proqramçınız yoxlaya bilər. Belə inteqrasiya aşağıdakı ünvanlara sorğu göndərir:
- https://foodsoul.pro/api/user/v1/ (həmçinin kz. və az.) — birinci versiya;
- https://foodsoul.pro/api/user/v2/ (həmçinin kz. və ua.) — ikinci versiya.
Əmin deyilsinizsə, inteqrasiyanızı kim idarə edirsə ona soruşun və ya dəstək xidməti ilə əlaqə saxlayın.
Keçidin üstünlükləri
CRM API User API-dən qat-qat çox imkanlara malikdir: burada sifarişlər və onların kartları, menyu, stop-list və qalıqlar, müştərilər, aksiyalar və hesabatlarla işləmək mümkündür.
Xüsusilə vebhook-lardan danışmaq lazımdır. Onların köməyi ilə CRM sisteminizə hadisələr barədə özü məlumat verir — məsələn, yeni sifariş və ya status dəyişikliyi barədə — və inteqrasiyaya API-ni daim sorğulamağa ehtiyac qalmır.
Daha bir üstünlük — ayrıca giriş tokenləridir. Hər bir inteqrasiyaya lazım olan səlahiyyətlərlə öz tokenini vermək, lazım gəldikdə isə onu istənilən vaxt bloklamaq və ya silmək mümkündür.
Necə keçmək olar
- CRM-də API token yaradın: “İnteqrasiyalar” → “API üçün giriş tokenləri”. Tokeni dərhal saxlayın: o, yalnız yaradılarkən göstərilir.
- Tokeni və CRM API sənədlərinə keçidi proqramçınıza göndərin.
- Proqramçı inteqrasiyanı CRM API-yə keçirəcək. Yalnız ünvanı dəyişmək kifayət deyil: indi əməliyyat sorğunun URL-ində göstərilir, sorğu və cavablarda ötürülən sahələrin siyahısı dəyişib.
Xatırladırıq ki, bunu 1 yanvar 2027-ci ilədək etmək lazımdır.
CRM API-nin tam sənədləri FoodSoul portalında yerləşir: docs.foodsoul.pro. Keçidlə bağlı kömək lazımdırsa, dəstək xidməti ilə əlaqə saxlayın.
Hörmətlə, FoodSoul komandası! Sizin üçün çalışırıq!