Genel Bakış
GET /jobs/{id} adresini defalarca sorgulamak yerine, işiniz tamamlandığında bir POST isteği almak için bir webhook URL’si sağlayabilirsiniz. Bu daha verimlidir ve gereksiz API çağrılarını azaltır.
Webhook Kullanma
Herhangi bir üretim isteğineX-Webhook-URL başlığını ekleyin. İş bir nihai duruma (completed, failed veya cancelled) ulaştığında, API sizin URL’nize tam iş verileriyle bir POST isteği gönderir.
Webhook Yükü
İş tamamlandığında, webhook URL’niz iş verileriyle bir POST isteği alır:En İyi Uygulamalar
Hızlı yanıt verin - Hemen bir 2xx durum kodu döndürün. Gerekirse webhook verisini asenkron olarak işleyin.
- Güvenlik için HTTPS uç noktalarını kullanın
- Yinelenen teslimatlar için idempotency uygulayın
- Hata ayıklama için webhook alımlarını kayıt altına alın
Webhook ve Sorgulama Karşılaştırması
HTTP isteği alabilen bir sunucunuz varsa webhook kullanın. İstemci tarafı uygulamalar için veya genel bir uç nokta sunamıyorsanız sorgulama kullanın.
Sonraki Adımlar
İş Yaşam Döngüsü
İş durumları ve durum sorgulaması hakkında bilgi edinin
Kod Örnekleri
Webhook işlemesi ile eksiksiz örnekleri görün