
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 — FoodSoul-un köhnə API-sini deaktiv edirik. Bu API vasitəsilə əvvəllər sifarişlərin statusları dəyişdirilirdi, qiymətlər və çatdırılma rayonları yenilənirdi, kuryerlərə nəzarət edilirdi. O, 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 yanvaradə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.ru/api/user/v1/ (həmçinin by.) — birinci versiya;
- https://foodsoul.ru/api/user/v2/ (həmçinin by.) — ikinci versiya.
Əmin deyilsinizsə, inteqrasiyanıza xidmət göstərən şəxsdən 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ışmağa dəyə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 olar, lazım gəldikdə isə istənilən vaxt onu 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”. Token yalnız bir dəfə, yaradılarkən göstərilir, dərhal saxlayın.
- 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.ru. 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!