Bu sayfada
Nasıl çalıştığını görün
Resimli anlatım · kurgusal örnek veriler
Genel bir HTTPS uç noktası oluşturun
Genel HTTPS URL'sine sahip bir web kancası ekleyin. Localhost, özel adresler, URL kimlik bilgileri, parçalar ve yönlendirme hedefleri kabul edilmez.
Bu tanıtım hesabınızı değiştirmez.
Tüm adımları okuyun
- Genel bir HTTPS uç noktası oluşturun
Genel HTTPS URL'sine sahip bir web kancası ekleyin. Localhost, özel adresler, URL kimlik bilgileri, parçalar ve yönlendirme hedefleri kabul edilmez.
- Etiketi
- Demo SMS alıcı
- Uç Nokta
- https://example.com/sms-webhook
- Tek seferlik sırrı kaydedin
Gösterildiğinde sırrı sunucunuzun korumalı yapılandırmasına kopyalayın. Daha sonra görüntülenemez; bunu biletlere veya genel koda koymayın.
- İmza sırrı
- ••••••••
- Ham gövde imzasını doğrulayın
HMAC-SHA256'yı ham istek gövdesi üzerinden imzalama sırrıyla doğrulayın ve x-TextVerified-imza değerini karşılaştırın. Tekilleştirme için kararlı X-Webhook-event-id değerini kullanın.
- İmza başlığı
- x-TextVerified-imzası: sha256=<hex>
- Olay kimliği
- x-TextVerified-olay kimliği: DEMO-EVENT-42
- Doğrula
- HMAC-SHA256(gizli, hamBody)
- Yeniden denemeleri onaylayın ve yönetin
Etkinliği güvenli bir şekilde kabul ettikten hemen sonra 2xx'i iade edin. Başarısız teslimat, aynı olay kimliğiyle en fazla 8 kez yeniden deneyebilir; bir olayı bir kez işleyin. Teslimattan önce mülkiyet tekrar kontrol edilir.
- İlk teslimat
- DEMO-ETKİNLİK-42 → 2xx
- Tekrarlanan teslimat
- Aynı olay kimliği → yinelenen eylem yok
- Web kancasını yönetin
Etiketini veya açıklamasını düzenleyin, teslimatı geçici olarak devre dışı bırakın veya artık ihtiyaç duyulmadığında silin. Değişiklikler sırasında alıcınızın tekilleştirme ve gizli işleme işlemlerini tutarlı tutun.
- Web Kancası
- Demo SMS alıcı
- Durum
- Devre Dışı
Genel uç nokta ekleme
Geliştiriciler'de Web Kancalarını açın ve Uç nokta ekleyin. Bir etiket, genel HTTPS URL'si ve isteğe bağlı bir açıklama girin. Localhost, özel ağ adresleri, URL'deki kimlik bilgileri ve yönlendirmeler uygun değildir. Nihai hedefi doğrudan ulaşılabilir hale getirin.
Oluşturulduktan sonra, modal tarafından gösterilen sırrı kopyalayın ve güvenli bir şekilde kaydedin. Kopyalama bu ekranı temizler; daha sonra okuyabileceğinize güvenmeyin. API anahtarlarından ayrı ve kamu kodunun dışında tutun.
Orijinal istek metnini doğrulayın
Olayları, JSON POST istekleri olarak gelir. HMAC-SHA256'yı tam ham istek gövdesi üzerinden webhook sırrıyla hesaplayın, ardından sha256=HEX_DIGEST formatlı X-Webhook-signature ile karşılaştırın. Doğrulamadan önce JSON'yi ayrıştırmayın ve yeniden serileştirmeyin; boşluk imzayı değiştirebilir. Uygulamanızda sabit zamanlı bir karşılaştırma kullanın.
Kararlı olay tanımlayıcısı olarak X-Webhook-event-id'yi kullanın. Orijinalliği doğrulayın, tanımlayıcıyı tekilleştirin, işi güvenli bir şekilde kaydedin/sıraya alın ve hemen 2xx yanıtı gönderin. Vücut alanları için güncel etkinlik sözleşmesini takip edin.
Yeniden denemeleri bekleyin ve uç noktayı yönetin
Teslimatı, 2xx olmayan yanıtları yeniden deneyebilir veya geri çekilmeyle birlikte sekiz denemeye kadar zaman aşımına uğrayabilir, böylece aynı olay birden fazla kez gelebilir. İşleyiciniz kopyalara tolerans göstermelidir. Yönlendirme, başarılı bir 2xx hedef yanıtı olarak sayılmaz.
Tablo, etiketi/açıklamayı düzenlemeyi, devre dışı bırakmayı ve kaldırmayı destekler. Teslimatı duraklatmayı devre dışı bırakın; kaldırma uç noktayı siler. Mevcut sahiplik, aktarım sonrası da dahil olmak üzere mesajları yönetir. Arızalar için HTTPS uç noktanızı, imza işlemenizi ve sunucu günlüklerinizi kontrol edin; kontrol panelinin tam teslimat günlüğü görüntüleyicisine sahip olduğunu varsaymayın.
Hesabınızla ilgili yardıma mı ihtiyacınız var?
Açık Destek