Webhook ve olay kuyruğu
Amaç
Webhook, Open Play’in bir olay oluştuğunda kendi sunucunuza gönderdiği imzalı HTTP isteğidir. Bu sayfa kayıtlı uç noktaları, her olayın uç noktaya gönderim denemelerini ve gönderilmeyi bekleyen olay kuyruğunu (outbox) gösterir. Sayfa salt okunurdur: uç nokta eklemek, silmek, başarısız teslimatı yeniden göndermek ya da sırrı görmek için panelde düğme yoktur. Uç noktalar REST ile kaydedilir; ayrıntı için Webhook’lar rehberine bakın.
Ne zaman kullanılır
- Sunucunuzun webhook’ları alıp almadığını doğrulamak için.
- Bir olayın neden gelmediğini (bekliyor mu, başarısız mı, hangi hata) anlamak için.
- Bir uç noktanın etkin olup olmadığını ve hangi olay türlerini dinlediğini görmek için.
Not
Webhook modülü kapalıysa webhook uçları yanıt vermez (
404,module_disabled). Modülü Oyun ayarları › Modüller sayfasından açın. Sayfayı görmek için rolünüzde webhook okuma yetkisi de gerekir.
Adım adım
- Doğru oyunu ve ortamı seçtiğinizden emin olun.
- “Webhook endpoints” tablosunda uç noktanızın adresini (URL), dinlediği olay türlerini ve durumunu kontrol edin. Süzgeç boşsa “tümü” yazar, yani uç nokta bütün olayları alır.
- “Delivery attempts / DLQ” tablosunda teslimatları durumuna göre süzün. Başarısız (failed) olanlar yeniden deneme hakkını tüketmiş teslimatlardır (DLQ, ölü mektup kuyruğu).
- “Hata” sütununda hatanın sınıfını ve varsa sunucunuzun döndüğü HTTP kodunu görürsünüz. Ham hata metni gösterilmez.
- “Outbox” tablosunda gönderilmeyi bekleyen ya da denenen olayları görürsünüz.
- Yeni verileri görmek için Yenile düğmesine basın.
Alanlar ve seçenekler
Bu sayfada doldurulacak bir form yoktur.
Tablolar
| Tablo | Sütunlar |
|---|---|
| Webhook endpoints | URL, Event filtreleri, Durum (enabled ya da disabled), Oluşturulma; Endpoint kimliği sütun menüsünden açılır |
| Delivery attempts / DLQ | Endpoint (URL, teslimat ve olay kimliği), Durum (pending, delivered, failed), Attempt (deneme sayısı), Hata, Oluşturma, Teslim; teslimat sırası ve outbox kimliği sütun menüsünden açılır |
| Outbox | Event (tür ve olay kimliği), Durum, Attempt, Retry (sonraki deneme zamanı), Oluşturma |
Yayımlanmış (tamamlanmış) outbox kaydında sonraki deneme zamanı “—” görünür. Olay türü gizli bir iç olaysa “redacted/private” yazar. Panel sırları, ham gövdeyi ve ham hata metnini hiçbir zaman göstermez.
Sık karşılaşılan durumlar
| Durum | Ne yapmalı |
|---|---|
| “Webhook yüzeyi yetki gerektiriyor” yazıyor | Rolünüzün webhook okuma yetkisi yok; bir yöneticiden isteyin. |
| Tablolar boş | Henüz uç nokta kaydetmemiş olabilirsiniz; doğru ortamı seçtiğinizi de kontrol edin. |
| Teslimat “failed” | Sunucunuz 2xx dönmüyor ya da ulaşılamıyor. Hata sütunundaki sınıfı ve kodu inceleyin; alıcınızı düzeltin. Panelden yeniden gönderme yoktur. |
| Aynı olay birden çok kez geldi | Teslimat en az bir kez yapılır; alıcınız olay kimliğiyle tekrarı elemelidir. Ayrıntı için rehbere bakın. |
| Uç noktanın sırrını göremiyorum | Sır yalnızca kayıt yanıtında bir kez döner; sonra hiçbir yerde gösterilmez. Yenilemek için uç noktayı silip yeniden kaydedin. |