İçeriğe geç

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ı

İstek sorunları
BelirtiOlası 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.
404Yanlış yol veya yanlış clientKey.Adresi ve clientKey değerini kontrol edin; sorun sürerse destekle iletişime geçin.
400, methodevidence.method eksik veya geçersiz.Beş geçerli değerden birini kullanın.
400, decidedAtTarih saat dilimi offset'i taşımıyor.+03:00 veya Z ekleyin.
422 CUSTOMER_MISMATCHcustomer.externalCustomerId bağlantıdaki müşteri kimliğiyle eşleşmiyor.Panelde gösterilen externalCustomerId değerini (şirketinizin kimliği) kullanın.
REJECTED + AMBIGUOUS_CONTACTAynı 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_REQUIREDETK ONAY kararı 3 iş gününden eski.Kişiden yeniden onay alın ve yeni olay gönderin.
REJECTED + CHANNEL_NOT_AVAILABLEETK kanalı izin kataloğunda aktif değil.İzin kataloğunu Rıza AL ekibiyle kontrol edin.
409 IDEMPOTENCY_CONFLICTAynı 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.
503Kanıt altyapısı geçici olarak hazır değil.Geri çekilerek tekrar deneyin; sürerse Rıza AL ekibine bildirin.
413Gövde çok büyük.Toplu isteği daha küçük parçalara bölün.
ETK onayı İYS'de görünmüyorBağ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ı

Webhook sorunları
BelirtiOlası nedenÇözüm
Webhook gelmiyorWebhook 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 edilemiyorAdres 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 edilemiyorAlan 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ıyorRotasyon 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).