20.11.2026, 07:43

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

  1. 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.
  2. Tokeni və CRM API sənədlərinə keçidi proqramçınıza göndərin.
  3. 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!