# Web kancalarıyla SMS olaylarını alın

Genel bir HTTPS uç noktası oluşturun, sırrını kaydedin ve imzalı etkinlikleri yinelenen güvenli işlemeyle doğrulayın.

2026-10-07 · TextVerified

## 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.