Artık FoodSoul'u istediğiniz herhangi bir sisteminize entegre edebilirsiniz

API erişim anahtarlarını ekledik. Bu, FoodSoul'u doğrudan muhasebe programınız, 1C, depo, analiz sistemi, bot veya kendi 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 hazır entegrasyonlarımız listesinden bağlantı kurulabiliyordu. 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 çalışabilirsiniz. Hangi erişimlerin entegrasyonunuza izin verileceği ise, anahtar için seçtiğiniz role bağlıdır.

Örneğin, “Operatör” rolüne sahip bir anahtarın şu yetkileri olur:

✅ 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 yetkileri içeren 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 vardır: bağlı şirketler, raporlar ve para çekme 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ş yapacağı anahtardır. Sisteminizin çalışan girişi veya şifresine ihtiyacı yoktur.

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:

• yalnızca bir ağa veya hesabınızdaki tüm ağlara erişim;
• geçici veya süresiz geçerlilik süresi;
• 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 yüzden 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 için:

📖 WIKI'de kurulum talimatı: https://wiki.foodsoul.ru/ru/public/api
📄 Tüm metodların açıklamasını (OpenAPI spesifikasyonu) teknik destekten talep edebilirsiniz. Yakında geliştirici portalı açılacak.

Saygılarımızla, FoodSoul ekibi! Sizin için çalışıyoruz!