Hata kodları
Her hata yanıtı {"error": {"code", "message", "fields"?}} biçimindedir. Programınız code'a göre karar versin; message Türkçedir ve kullanıcıya gösterilebilir.
Platform API'si
| HTTP | code |
Anlamı | Ne yapmalı |
|---|---|---|---|
| 400 | invalid_json |
Gövde geçerli JSON değil | İsteği düzeltin |
| 401 | unauthorized |
API anahtarı yok ya da geçersiz | Anahtarı ve Bearer önekini kontrol edin |
| 402 | insufficient_credits |
Platformun sahibi üyenin (kurum platformunda kurumun) kredisi bu isteğe yetmiyor (yalnız panelden açılan canlı platformlar) | Panelden kredi satın alın |
| 403 | platform_disabled |
Platformun erişimi kapatılmış (ya da sahibi üyelik kapatılmış) | Platformu panelden açın ya da Damga yöneticisiyle görüşün |
| 403 | email_unverified |
Platformun sahibi üyenin e-postası doğrulanmamış | Üye e-postasını doğrulasın |
| 403 | domain_not_verified |
E-posta mühürü: From alan adı bu hesapta doğrulanmamış | Panelde alan adını DNS TXT kaydıyla doğrulayın (E-posta mühürleme) |
| 403 | account_required |
E-posta mühürü: platform bir üye ya da kurum hesabına bağlı değil | Panelden açılan bir platformun anahtarını kullanın |
| 404 | not_found |
İstek yok ya da başka platforma ait | Kimliği kontrol edin |
| 405 | method_not_allowed |
Yanlış HTTP yöntemi | — |
| 409 | already_signed |
Belge zaten imzalandı | İmzayı okuyun |
| 409 | expired |
İstek süresi doldu | Yeni istek açın |
| 409 | cancelled |
İstek iptal edildi | Yeni istek açın |
| 409 | not_signed |
İmza henüz yok (/signature) |
Bekleyin ya da durumu okuyun |
| 410 | document_unavailable |
Belge saklama süresi doldu (30 gün) | Belge sizde |
| 413 | document_too_large |
PDF sınırı aşıldı (varsayılan 10 MB) | Belgeyi küçültün |
| 422 | validation_failed |
Alanlar geçersiz; ayrıntı fields içinde |
Alanları düzeltin |
| 429 | rate_limited |
Hız sınırı aşıldı | message'daki süre kadar bekleyin |
| 500 | internal |
Damga'da beklenmeyen hata | Tekrar deneyin; sürerse bildirin |
İmza sayfasının kullanıcıya gösterdikleri
Bu hatalar platforma dönmez; kullanıcı sayfada görür ve genellikle kendisi çözebilir. Destek ekibiniz için:
code |
Kullanıcının gördüğü | Çözüm |
|---|---|---|
agent_offline |
Damga uygulaması bağlı değil | "Damga'yı başlat"a basmak; uygulama kurulu değilse kurmak |
certificate_not_found |
Seçilen sertifika artık görünmüyor | e-İmza USB'sini takıp "e-İmza USB'lerini yeniden oku" |
signer_mismatch |
Bu sertifika beklenen kişiye ait değil | Doğru kişinin e-imza USB'si. İstekteki signer.national_id'yi kontrol edin |
certificate_expired |
Sertifika süresi dışında | Sertifika yenilenmeli |
pin_locked |
e-İmza PIN'iniz kilitli | Sertifika sağlayıcısının PUK / PIN çözme aracı |
confirm_final_attempt |
Bu deneme e-imza USB'nizi kilitleyebilir | Kullanıcının ayrıca onay vermesi gerekir |
too_many_attempts |
Deneme hakkı doldu (istek başına 8) | Platformdan yeni istek |
signature_invalid |
İmza belgeyle doğrulanamadı | Nadir; Damga'yı yeniden başlatıp denemek |
test_certificate |
Test sertifikası canlıda kabul edilmez | Gerçek e-imza USB'siyle imzalamak |
timestamp_failed |
Zaman damgası alınamadı | Biraz sonra yeniden denemek; sürerse Damga sunucusunun TSA ayarları (tsa.*) |
validation_data_failed |
Uzun süreli doğrulama bilgisi (OCSP / CRL) alınamadı | Sertifika sağlayıcısının OCSP / CRL sunucusu erişilemiyor olabilir; sonra yeniden denemek. "Sertifika iptal edilmiş" diyorsa sertifika kullanılamaz |
timestamp_invalid |
İmzadaki zaman damgası Damga'dan alınmamış | Damga uygulamasını güncellemek / yeniden başlatmak |
Damga uygulamasının gördükleri
agent_link_invalid (401): bağlantı yenilendi ya da istek bitti. Sayfada "Damga'yı başlat" yeniden basılırsa eski uygulama penceresi kendiliğinden kapanır.