
Önemli: User API entegrasyonları 1 Ocak 2027 tarihinden itibaren çalışmayı durduracaktır
User API’yi devre dışı bırakıyoruz — bu, daha önce sipariş durumlarının değiştirildiği, fiyatların ve teslimat bölgelerinin güncellendiği, kuryelerin yönetildiği eski FoodSoul API’sidir. Uzun zamandır güncellenmiyor: tüm yeni özellikleri CRM API’ye ekliyoruz.
Entegrasyonunuz User API üzerinden çalışıyorsa, 1 Ocak’a kadar CRM API’ye geçirmeniz gerekiyor. Aksi takdirde, bu tarihten sonra FoodSoul tüm isteklerinize hata ile yanıt verecek. Geçişe nasıl hazırlanacağınızı aşağıda anlatıyoruz.
Entegrasyonunuzu nasıl kontrol edebilirsiniz
Entegrasyonunuzun User API üzerinden çalışıp çalışmadığını geliştiriciniz kontrol edebilir. Böyle bir entegrasyon şu adreslere istek gönderir:
- https://foodsoul.ru/api/user/v1/ (veya by.) — birinci sürüm;
- https://foodsoul.ru/api/user/v2/ (veya by.) — ikinci sürüm.
Emin değilseniz, entegrasyonunuzu yöneten kişiye sorun veya destek ekibimize yazın.
Geçişin avantajları
CRM API, User API’den çok daha fazlasını yapabilir: siparişler ve kartları, menü, stop listesi ve stoklar, müşteriler, kampanyalar ve raporlarla çalışabilirsiniz.
Webhook’lardan ayrıca bahsetmek gerekir. Webhook’lar sayesinde CRM, sisteminize yeni bir sipariş veya durum değişikliği gibi olayları kendisi bildirir — entegrasyonun API’yi sürekli sorgulamasına gerek kalmaz.
Bir diğer avantaj ise ayrı erişim token’larıdır. Her entegrasyona gerekli yetkilerle kendi token’ı verilebilir ve gerektiğinde anında engellenip silinebilir.
Nasıl geçiş yapılır
- CRM’de API token’ı oluşturun: “Entegrasyonlar” → “API erişim token’ları”. Token yalnızca oluşturulurken gösterilir, hemen kaydedin.
- Token’ı ve CRM API dokümantasyonunun bağlantısını geliştiricinize iletin.
- Geliştirici entegrasyonu CRM API’ye taşıyacak. Sadece adresi değiştirmek yeterli değildir: artık işlem istek URL’sinde belirtiliyor ve istek/yanıt alanlarının listesi değişti.
Bunu 1 Ocak 2027’ye kadar yapmanız gerektiğini hatırlatırız.
CRM API’nin tam dokümantasyonu FoodSoul portalında: docs.foodsoul.ru. Geçişte yardıma ihtiyacınız olursa destek ekibimize yazabilirsiniz.
Saygılarımızla, FoodSoul ekibi! Sizin için çalışıyoruz!