Sıkça Sorulan Sorular (SSS)
Aşağıda Adisyo API ve Adisyo Webhook ile ilgili en sık sorulan soruların yanıtlarını bulabilirsiniz.
1. Webhook entegrasyonu mevcut mu?
Şu anda Adisyo API’de webhook desteği bulunmamaktadır. Sipariş verilerini almak için belirli aralıklarla API üzerinden veri çekmeniz gerekmektedir. Webhook ile ilgili gelişmeleri Webhook sayfasından takip edebilirsiniz.
2. Bir siparişin güncellendiğini nasıl anlayabilirim?
Siparişlerin güncellenip güncellenmediğini anlamak için Son Siparişleri Görüntüleme veya Tamamlanmış Siparişleri Görüntüleme endpoint’lerini kullanabilirsiniz. API’den aldığınız yeni verileri, daha önce kaydettiğiniz siparişlerle karşılaştırarak değişiklikleri tespit edebilirsiniz.
Ancak daha güncel ve otomatik bir çözüm için webhook entegrasyonunu kullanmanızı öneririz. Webhook ile siparişlerdeki değişiklikler size anlık olarak iletilebilir. Webhook desteği ve gelişmeleri için Webhook sayfasını takip edebilirsiniz.
3. Ürün eklemek için bir API mevcut mu?
Hayır, ürün ekleme işlemleri henüz API üzerinden yapılamamaktadır. Ürün yönetimi Adisyo paneli (https://pos.adisyo.com (opens in a new tab)) üzerinden gerçekleştirilmelidir.
4. Ürün yönetimi nasıl yapılır?
Ürünler Adisyo paneli (https://pos.adisyo.com (opens in a new tab)) üzerinden tanımlanır.
Tanımlanan ürünleri API aracılığıyla uygulamanıza çekebilir ve sipariş gönderirken Adisyo’da bulunan productunitid ile eşleştirerek kullanabilirsiniz.
Daha fazla bilgi için Ürün Listesini Görüntüleme ve Sipariş Oluşturma sayfalarını inceleyebilirsiniz.
5. İstek limitleri (rate limiting) kaldırılabilir mi?
Hayır, istek limitleri uygulamanın performansı ve istikrarı için belirlenmiştir. Müşteri veya firma bazında özel limit kaldırımı ya da artırımı yapılamamaktadır.
6. Test ortamı var mı?
Şu anda ayrı bir test ortamı bulunmamaktadır. Testlerinizi canlı ortamda aşağıdaki yöntemlerle gerçekleştirebilirsiniz:
- Test amaçlı ayrı bir restoran oluşturabilirsiniz.
- Gerçek restoran ortamında testlerinizi sürdürebilirsiniz.
7. API Key (x-api-key) ve API Secret (x-api-secret) nasıl alınır?
API Key ve API Secret, her restoran için Adisyo tarafından özel olarak oluşturulup paylaşılmaktadır. Bu bilgilere sahip olmak için Adisyo ile iletişime geçmeniz gerekmektedir.
Daha fazla bilgi için Authorization bölümüne göz atabilir veya iletişim formu (opens in a new tab) üzerinden destek alabilirsiniz.
8. Consumer Key (x-api-consumer) nedir, nasıl doldurulmalıdır?
x-api-consumer (veya Consumer Key), entegrasyon yapan restoran veya firmanın adını belirtmek için kullanılan bir başlık (header) bilgisidir.
Bu alan, Adisyo üzerinde sizin veya müşterinizin restoran/firma adını Türkçe karakterler ve boşluklar dahil olacak şekilde eksiksiz biçimde içermelidir.
Örneğin:
--header "x-api-consumer: BenimKuryem.net"--header "x-api-consumer: KuryeSepeti - Kardeşler Kebap"--header "x-api-consumer: Burger Art - Web Siparişleri"
Daha fazla bilgi için Authorization bölümüne bakabilirsiniz.
9. Birden fazla şubem varsa, API isteğimin hangi restorana gittiğini nasıl anlarım?
Birden fazla şubeye sahip restoran zincirlerinde, her restoranın verilerine erişim için Adisyo API’ye gönderdiğiniz başlıklar (headers) belirleyici rol oynar:
x-api-key: Firmanızın entegrasyon için yetkilendirildiğini gösterir ve genellikle sabittir.x-api-secret: Her restoran için özel olarak tanımlanır ve restoran bazında değişir.
Yani, örneğin “Son siparişleri getir” gibi bir istek gönderdiğinizde, hangi restoranın x-api-secret bilgisini kullanırsanız o restorana ait siparişlere erişirsiniz.
Özetle: Her şube için ilgili x-api-secret bilgisini kullanarak, o şubeye ait verileri güvenli bir şekilde çekebilirsiniz.
İletişim
Daha fazla bilgi için bizimle buradan (opens in a new tab) iletişime geçebilirsiniz.