
Artık FoodSoul'u herhangi bir sisteminize entegre edebilirsiniz
API erişim anahtarlarını ekledik. Bu, FoodSoul'u doğrudan muhasebe programınız, deponuz, analiz sisteminiz, botunuz veya kendi geliştirdiğiniz yazılımınızla entegre edebileceğiniz anlamına geliyor. Artık verileri manuel olarak dışa aktarmanıza ve aktarmanıza gerek yok.
Önceden yalnızca listemizdeki hazır entegrasyonlara bağlanmak mümkündü. Artık kendi entegrasyonunuzu oluşturabilirsiniz.
FoodSoul API erişim anahtarları ne işe yarar?
Bir anahtar sayesinde CRM'in çoğu bölümünde işlem yapabilirsiniz. Hangi erişimlerin entegrasyonunuza izin verileceği ise, anahtar için seçeceğiniz role bağlıdır.
Örneğin, “Operatör” rolüne sahip bir anahtarın yetkileri şunlardır:
✅ Yapılabilir: Ürünleri, kategorileri, stop listelerini, stok miktarlarını, siparişleri, yorumları ve adresleri değiştirmek, ödemelerle çalışmak.
❌ Yapılamaz: Muhasebe raporlarını ve karşı tarafları görüntülemek.
Böyle bir anahtar, örneğin stok miktarlarını ve stop listelerini otomatik olarak güncelleyen bir depo yönetim programı için uygundur. Her entegrasyon için yalnızca gerekli yetkilere sahip bir rol seçin: Anahtarın yetkileri ne kadar azsa, o kadar güvenlidir.
Ortaklık programı katılımcıları için ayrı istekler mevcuttur: bağlı şirketler, raporlar ve ödeme işlemleri.
Nasıl bağlanılır?
1. CRM'de “API erişim anahtarları” bölümünü açın ve bir anahtar oluşturun. Anahtar, sisteminizin FoodSoul'a giriş yapmasını sağlayan bir anahtardır. Çalışan girişi veya şifresi gerekmez.
2. Anahtar için bir rol seçin. Anahtar, bu rolün yetkilerini alır, ancak sizin sahip olduğunuzdan fazlasını alamaz.
3. Gerekirse şu kısıtlamaları belirleyin:
- sadece bir ağa veya hesabınızdaki tüm ağlara erişim;
- geçici veya süresiz geçerlilik süresi;
- isteklere izin verilen IP adresleri listesi. Diğer adreslerden gelen istekler reddedilecektir.
4. Anahtarı sisteminizdeki her isteğe ekleyin:
Authorization: Bearer fs_api_...
Anahtar bir ağa bağlı değilse, gerekli olanı başlıkta belirtin:
Chain: chain_id
Anahtar ayarlarını istediğiniz zaman değiştirebilirsiniz, anahtarın kendisi aynı kalır. Ayrıca anahtarı engelleyebilir, tekrar etkinleştirebilir veya silebilirsiniz.
❗️ Güvenlik hakkında önemli
- Tam anahtar yalnızca oluşturulurken bir kez gösterilir. Hemen kaydedin. Anahtarı şifreli olarak saklıyoruz ve geri getirme imkanı yoktur, bu nedenle kaybolan anahtar geri alınamaz. Yeni bir anahtar oluşturup entegrasyonda değiştirmeniz gerekir.
- Her entegrasyon için ayrı bir anahtar oluşturun. Böylece gerekirse bir entegrasyonu devre dışı bırakabilir, diğerleri çalışmaya devam eder.
Daha fazla bilgi nerede bulabilirim:
📄 Tüm yöntemlerin açıklamasını (OpenAPI spesifikasyonu) teknik destekten talep edebilirsiniz. Yakında geliştirici portalı açılacaktır.
Saygılarımızla, FoodSoul ekibi! Sizin için çalışıyoruz!