Webhook

Her tarama sonucunu gerçek zamanlı olarak kendi HTTP uç noktanıza gönderin. Webhook entegrasyonunu etkinleştirmek ve kimlik doğrulama ile JSON gövdesini yapılandırmak için aşağıdaki üç adımı izleyin.

Önemli

Webhook bildirimleri almak istiyorsanız Tarama Ayarları bölümünde Gerçek Zamanlı Gönderim seçeneğini açmalı ve hedef olarak Webhook seçmelisiniz.

1. Ayarlar > Entegrasyon > Webhook'u açın

Telefonunuzda WiScanner uygulamasını açın ve şuraya gidin: Ayarlar > Entegrasyon. Görünen listede Webhook seçeneğine dokunun. Bu, Webhook yapılandırma penceresini açar.

Ayarlar → Entegrasyon ekranından Webhook'u açma

2. Webhook penceresi ve Temel Kimlik Doğrulama

Webhook penceresi açıldığında, üstte hedef URL alanını ve altında isteğe bağlı bir Kimlik Doğrulama bölümünü görürsünüz.

Webhook isteğinin gönderileceği tam URL'yi girin (örneğin, API uç noktanız).
Sunucunuz Temel Kimlik Doğrulama gerektiriyorsa, kullanıcı adı ve parolayı Kimlik Doğrulama bölümüne girin.
Bu kimlik bilgilerini gerçekten göndermek için Basic Auth (veya benzer adlı) bayrağını açın ve etkin olduğundan emin olun.
Bayrak etkinleştirildiğinde, WiScanner kullanıcı adı ve parolayı Webhook isteğinde bir HTTP Basic Authentication başlığı olarak ekler.

URL ve kimlik doğrulama alanlarını içeren Webhook penceresi

Basic Auth için etkinleştirilmiş Webhook kimlik doğrulama seçeneği

3. Her taramayla gönderilen JSON gövdesi

Her tarama için Webhook, sunucunuza JSON gövdeli bir HTTP POST isteği gönderir. Arka ucunuz bu gövdeyi alıp işlemeye hazır olmalıdır.

Aşağıdaki örnek, tipik bir JSON gövde yapısını gösterir. Tam alan adları, uygulamanızın sunduğu seçeneklere göre değişebilir; ancak genel mantık benzerdir:

{
  "GroupName": "groupname",
  "Input": "86937832",
  "Type": "barcode",
  "Name": "test",
  "PrefixValue": "value",
  "PrefixCommand": "enter",
  "SuffixValue": "value",
  "SuffixCommand": "enter"
}

Sunucunuz, taranan değeri (Input), ilgili grup adını (GroupName), türü (Type) ve isteğe bağlı ek alanları (Ad, PrefixValue, PrefixCommand, SuffixValue, SuffixCommand) almak için bu JSON'u okuyabilir ve bunları kendi iş akışınıza aktarabilirsiniz (örneğin stok güncelleme, sipariş satırı oluşturma veya kayıt tutma).

JSON gövdesine ek olarak, her geri çağırma bir x-wusername HTTP başlığı da içerir. Değeri, telefonda yapılandırılan profil adıyla aynıdır; böylece taramayı hangi kullanıcının veya cihazın gönderdiğini kolayca belirleyebilirsiniz.

Özet

Adım 1: Uygulamada Ayarlar > Entegrasyon > Webhook'a gidin.
Adım 2: Webhook URL'sini girin, isteğe bağlı olarak Basic Auth kimlik bilgilerini ekleyin ve bayrağı etkinleştirin.
Adım 3: Sunucunuzu, WiScanner'ın gönderdiği JSON gövdesini alıp işleyecek şekilde yapılandırın.