Entegrasyonlar

Bu bölüm, efuar'ı organizatörün kendi yazılımlarına ve fuar girişindeki donanıma bağlamanın yollarını anlatır. Muhasebe ya da ERP sisteminiz, web siteniz ve raporlama araçlarınız efuar'daki fuar ve katılım bilgilerini okur ve olaylardan haberdar olur; kapıdaki turnike ve QR okuyucular ziyaretçi kodlarını efuar'a sorar. Sayfalar, bu bağlantıları kuracak bilgi işlem ekibiniz, yazılım geliştiriciniz ya da donanım tedarikçiniz için yazılmıştır ve istek ile yanıt örnekleri içerir.

Entegrasyonlar paketinizde API Erişimi özelliğinin açık olmasını ister. Özellik kapalıyken Ayarlar › API ve Webhook ekranı menüde görünmez, API anahtarları reddedilir ve webhook iletileri gönderilmez. Giriş cihazları ayrıca Davetiye / QR özelliğini ister.

Olağan iş sırası

1. Organizatör API'si: Ayarlar › API ve Webhook ekranında bir API anahtarı oluşturun; sisteminiz fuarlarınızı ve fuarlara katılan firmaları bu anahtarla okur.
2. Webhook'lar: bir firma ya da kişi oluşturulduğunda, bir sözleşme onaylandığında, bir tahsilat kaydedildiğinde ya da bir ziyaretçi kaydolduğunda sisteminize imzalı bir ileti gönderilmesi için bir uç tanımlayın.
3. Giriş cihazları: fuarın kapılarına turnike ya da okuyucu ekleyin; cihaz kendi anahtarıyla her kodu efuar'a sorar, internet kesildiğinde önceden indirdiği listeyle karar verir.

Anahtarların ve uçların yönetildiği ekranın kendisi API ve Webhook sayfasında anlatılır.

Temel kavramlar

• Anahtar bir kez gösterilir. API anahtarı, webhook imza anahtarı ve cihaz anahtarı yalnız oluşturuldukları sayfada bir kez görünür. Kaybedilen anahtar geri getirilemez; yeni bir anahtar oluşturulur ya da anahtar yenilenir.
• API anahtarı organizatörün tamamı adına okur. Bütün şubelerinizin fuarlarını görür ve kullanıcıların şube erişimine bağlı değildir. Cihaz anahtarı ise yalnız eklendiği fuarın, eklendiği kapısı için çalışır.
• API yalnız okur. API ile kayıt oluşturulamaz ya da değiştirilemez; tutarlar ve kişisel veriler API'de yoktur. Sözleşme ve tahsilat tutarları webhook iletileriyle gelir.
• Kurallar efuar'da kalır. Kapıdaki cihaz kodu kendi kurallarıyla değerlendirmez: karar, kapı ekranıyla aynı kurallarla efuar'da verilir; bağlantı yokken verilen kararlar da bağlantı gelince yeniden denetlenir.