Gelişmiş Özellik: Bu özellik sadece ileri düzey kullanıcılar için önerilir ve kodlama gerektirir.
Webhook nedir?
Webhook, bir uygulamanın diğer uygulamalara gerçek zamanlı bilgi sağlaması için bir yoldur. Bir webhook, diğer uygulamalara verileri olduğu anda iletir ve bu da verileri derhal almanız anlamına gelir. Bu, gerçek zamanlı olarak veri elde etmek için çok sık veri taramanız gereken tipik bir API'den farklıdır. Bu webhook'u çok daha verimli hale getirir ve çoğu durumda daha iyi bir seçenek sunar.
Ne zaman webhook kullanmalıyım?
Universe'de her yeni bilet alındığında sunucunuza veya Zapier entegrasyonumuz tarafından desteklenmeyen başka bir uygulamaya veri göndermek istiyorsanız, o zaman bir webhook kullanmanız gerekir.
Ne zaman webhook yerine API kullanmalıyım?
Verilerin yalnızca isteği başlattığınızda gönderilmesini istiyorsanız ve verilerin yalnızca daha küçük bir alt kümesini almakla sınırlamak istiyorsanız.
Webhook kullanmak için neye ihtiyacım var?
Webhook kullanmak için, webhook kullanması mümkün olacak bir şeyiniz olması gerekir. Bu yüzden, bazı kodları yazabilmeniz veya yazan birinden yardım almanız gerekecektir.
Universe webhook hakkında neleri bilmem gerekiyor?
Bir bilet satın alındığında, aşağıdaki başlıklarla sağlanan Payload URL'sine bir
JSON kodlu HTTP
POST isteği göndereceğiz:
X-Uniiverse-Event - Etkinlik türü
X-Uniiverse-Signature - Hook'un secret'ını anahtar olarak kullanan (yapılandırılmışsa) HMAC hex payload paketi.
İsteğin gövdesi, verilerin
JSONkodlu bir gösterimi olacaktır.
Başlarken:
1. Webhook'u kurun
Universe hesabı içinde 'Ayarlar'a gidin.
2. 'Hesap' sekmesinde Webhooks Bölümüne gidin ve ' WebhookEkle' düğmesini tıklayın.
3. Webhook'u yapılandırın
Webhook'u yapılandırmak için aşağıdaki alanları doldurmanız gerekir:
URL: Bu, web servisinizin URL’si veya POST isteğini yerine getirmek için kurduğunuz herhangi bir şey olacaktır.
Yalnızca denemek istiyorsanız, Universe verilerini geçici olarak göndermek ve veri biçimini incelemek için RequestBin URL'sini ( http://requestb.in/ adresinden) kullanabilirsiniz.
Secret: secret, diğer uygulamaların verilerinize erişmesini önlemek için Universe ile uygulamanız arasında kullanılan bir parola gibidir.
Etkinleştir: webhook'u etkinleştirmek istiyorsanız bu kutuyu işaretlemeniz gerekir. Webhook'u istediğiniz zaman etkinleştirebilir veya devre dışı bırakabilirsiniz.
4. Verileri kullanmak için kod yazın
Her yeni bir bilet satın alındığında Universe, etkinlikle ilgili olarak ihtiyaç duyacağınız tüm verileri ve satın alımları, uygulamanıza yerleştirmek için size gönderir.
Burada gönderdiğimiz tüm verileri içeren örnek bir istek görebilirsiniz.
Her nesnenin açıklamasını http://developers.universe.com adresinde bulabilirsiniz.
Etkinlikler
Şu anda, webhook'u tetikleyen yalnızca bir etkinlik var:
ticket
_purchase - bir bilet satın aldığınızda veya listenizden biri için bir bilet satın alındığında.
Sorun Giderme
Herhangi bir sebepten dolayı Payload URL’sine yapılan POST isteği başarısız olursa, webhook aktif değil olarak işaretlenir ve kullanıcı ayarlarınızdan tekrar etkinleştirmeniz gerekir.