Hatalar
Servis hataları
Bölüm başlığı “Servis hataları”Tüm ServerCall ve Authentication çağrıları sonucu TechsignServiceListener ile döner. Hata durumunda onFailure(Exception e) çağrılır; e aşağıdaki türlerden biri olabilir (com.techsign.rkyc.error):
| Hata | HTTP | Anlamı |
|---|---|---|
BadRequestException |
400 | İstek geçersiz (örneğin eksik veya hatalı alan) |
UnauthorizedException |
401 | Oturum geçersiz veya süresi dolmuş |
ForbiddenException |
403 | Bu işlem için yetki yok |
NotFoundException |
404 | Kayıt bulunamadı |
InternalServerError |
500 | Sunucu hatası |
ServerErrorException |
diğer 4xx/5xx | Diğer sunucu hataları |
Belge algılama
Bölüm başlığı “Belge algılama”OcrListener.cardDetectionFailed(CardDetectionErrorsModel) belgenin neden yakalanamadığını bildirir. Kullanıcıyı yönlendirmek için kullanın:
| Alan | false ise |
|---|---|
isPredictionScoreEligible() |
Belge net algılanamadı |
isWidthHeightRatioEligible() |
Belge açılı tutuluyor |
isAreaRatioEligible() |
Belge çok uzak veya çok yakın (getAreaErrorRatio()) |
isImageSharpnessRatioEligible() |
Görüntü bulanık |
isHologramScoreEligible() |
Hologram parlaması var |
getCardType() algılanan belge türünü verir; CardType.NO_CARD kadrajda belge olmadığını gösterir.
PassportReaderCallback.error(Exception e) içinde e bir NFCException ise ((NFCException) e).getNfcError() ile nedeni alın:
| Hata | Anlamı | Ne yapılmalı |
|---|---|---|
InvalidMrzKey |
Seri numarası, doğum tarihi veya son geçerlilik tarihi belgeyle eşleşmiyor | Bilgileri kullanıcıya yeniden onaylatın |
ConnectionError |
Bağlantı koptu | Tekrar deneyin |
AuthenticationFailed |
Belge ile telefon arasındaki mesafe fazla | Kılıfı çıkarıp belgeyi sabit tutarak tekrar deneyin |
ActiveAuthNotSupportedForPassport |
Belge aktif kimlik doğrulamayı desteklemiyor | Nonce olmadan (null) tekrar okuyun |
InvalidTag |
Okunan kart bir kimlik belgesi değil (örneğin kredi kartı) | Doğru belgeyi okutun |
UnknownError |
Beklenmeyen hata | Ayrıntı için getCardServiceException() |