Sorun giderme
Sık karşılaşılan istek ve webhook sorunları için belirti, olası neden ve çözüm tabloları.
Son güncelleme:
İstek sorunları
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 (her istek) | Yanlış clientKey (panelden oluşturulan bağlantılarda direct), yanlış veya eski API anahtarı, bağlantı pasif ya da iptal edilmiş. | Panelde Hesabım → Şirket Ayarları → API Erişimi sekmesinden bağlantı durumunu kontrol edin; gerekirse anahtarı yenileyin. |
402 MODULE_NOT_IN_PLAN | Şirketinizin paketinde API Erişimi modülü yok. | Paketinize API Erişimi modülünü ekletin; aynı isteği tekrar denemek işe yaramaz. |
| 401 (anahtar doğru) | İmza API anahtarıyla hesaplandı; gövde imzadan sonra değişti; saat farkı 300 saniyeden fazla; zaman damgası milisaniye cinsinden. | İmzayı webhook secret'ı ile, ham baytlar üzerinden, zamanDamgası + "." + gövde dizgisiyle ve saniye cinsinden zamanla hesaplayın. |
| 404 | Yanlış yol veya yanlış clientKey. | Adresi ve clientKey değerini kontrol edin; sorun sürerse destekle iletişime geçin. |
400, method | evidence.method eksik veya geçersiz. | Beş geçerli değerden birini kullanın. |
400, decidedAt | Tarih saat dilimi offset'i taşımıyor. | +03:00 veya Z ekleyin. |
422 CUSTOMER_MISMATCH | customer.externalCustomerId bağlantıdaki müşteri kimliğiyle eşleşmiyor. | Panelde gösterilen externalCustomerId değerini (şirketinizin kimliği) kullanın. |
REJECTED + AMBIGUOUS_CONTACT | Aynı telefon/e-posta şirkette birden çok kişide kayıtlı. | Kişi mükerrerlerinin birleştirilmesi için Rıza AL ekibiyle iletişime geçin. |
REJECTED + CONSENT_TOO_OLD_REAPPROVAL_REQUIRED | ETK ONAY kararı 3 iş gününden eski. | Kişiden yeniden onay alın ve yeni olay gönderin. |
REJECTED + CHANNEL_NOT_AVAILABLE | ETK kanalı izin kataloğunda aktif değil. | İzin kataloğunu Rıza AL ekibiyle kontrol edin. |
409 IDEMPOTENCY_CONFLICT | Aynı olay kimliği farklı içerikle gönderildi. | Yeni externalEventId kullanın. |
| 429 | İstek sınırı aşıldı. | Geri çekilin, toplu istekleri zamana yayın. |
| 503 | Kanıt altyapısı geçici olarak hazır değil. | Geri çekilerek tekrar deneyin; sürerse Rıza AL ekibine bildirin. |
| 413 | Gövde çok büyük. | Toplu isteği daha küçük parçalara bölün. |
| ETK onayı İYS'de görünmüyor | Bağlantınız test modunda (ETK kararları İYS'ye gönderilmez), şirketin İYS bağlantısı hazır değil (panelde uyarı görünür), kişinin ilgili alıcı değeri (telefon/e-posta) yok veya kayıt zaten aynı değerde (DUPLICATE). | Test modunu kapatın ve İYS bağlantı durumunu kontrol edin; sorun sürerse destekle iletişime geçin. |
Webhook sorunları
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Webhook gelmiyor | Webhook adresi tanımlı değil, bağlantı pasif ya da iptal edilmiş, kişi bu bağlantıdan hiç bildirilmemiş/sorgulanmamış veya değişikliği kendiniz başlattınız (döngü koruması). | Webhook adresini ve bağlantı durumunu kontrol edin; sorun sürerse destekle iletişime geçin. |
| Teslimat başarısız (HTTP 4xx/5xx) | Alıcı uç noktanız hata döndü veya secret uyuşmuyor. | Alıcıyı düzeltin; DEAD olan teslimatı panelden yeniden gönderin. |
| Port nedeniyle teslim edilemiyor | Adres 443 dışında bir port kullanıyor. | Uç noktayı 443'te yayınlayın ve adresi panelden güncelleyin (adres değişince secret yenilenir; yeni secret bir kez gösterilir). |
| Özel adres nedeniyle teslim edilemiyor | Alan adı özel/iç bir IP'ye çözülüyor. | Herkese açık bir IP kullanın. |
| Zaman aşımı | Alıcı 10 saniye içinde yanıt vermedi. | Hızlı 2xx dönün, işi asenkron yapın. |
| Webhook imzası doğrulanmıyor | Rotasyon penceresinde tek secret kontrol ediliyor veya gövde yeniden serileştirildi. | İki imzayı da kabul edin; ham gövde üzerinden hesaplayın. |
API anahtarınızı ve bağlantınızı yönetmek için panelde Hesabım → Şirket Ayarları → API Erişimi sekmesini kullanın. Hesabım sayfasını aç (giriş yapmanız gerekir).
