Belge sahteciliği tespiti API

API Giriş

Sahtecilik tespitinde uzmanlaşmış yapay zeka teknolojisi, ImgAuth.com API'sini kullanarak her zamankinden daha kolay hale getirildi. Sadece birkaç satır kodla bu teknolojiyi uygulamanıza getirebilirsiniz.

İstek Parametreleri: Base64 ile kodlanmış görsel verisi, ardından URL-encode edilir. En fazla 10 MB. En kısa kenar en az 512 px, en uzun kenar en fazla 8192 px olmalıdır. jpg/jpeg/png/bmp desteklenir. image veya url gönderin.
Yanıt parametreleri: API yanıt alanları referansı

API Giriş

finans ekipleri faturaları ve makbuzları inceler
İK ekipleri sertifikaları ve taramaları inceler
sigorta ekipleri talep belgelerini inceler

Kimlik Doğrulama

{your-api-domain} değerini hesap panelinizde gösterilen API uç noktasıyla değiştirin.

İstekleri hesap API uç noktanız ve Bearer token ile doğrulayın. API kredilerini satın aldıktan sonra uç noktanızı ve token’ınızı hesap panelinde görebilirsiniz. Token’ınızı gizli tutun ve asla herkese açık depolara göndermeyin.

POSThttps://api.imgauth.com/v1/document-fraud-detection

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

İstek Parametreleri

Parametre	Tür	✓	Açıklama
image	string	✓	Base64 ile kodlanmış görsel verisi, ardından URL-encode edilir. En fazla 10 MB. En kısa kenar en az 512 px, en uzun kenar en fazla 8192 px olmalıdır. jpg/jpeg/png/bmp desteklenir. image veya url gönderin.
detect_proportion	boolean	—	Tahrifat güven skorunun döndürülüp döndürülmeyeceğini belirtir. Varsayılan: false. true skoru döndürür, false döndürmez.
return_heatmap	boolean	—	Sahtecilik heatmap’inin döndürülüp döndürülmeyeceğini belirtir. Varsayılan: false. true Base64 heatmap döndürür, false döndürmez.
location	boolean	—	Entegrasyonunuzu oluşturmak ve hata ayıklamak için bu örnekleri kullanın

Örnek HTTP İsteği

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "detect_proportion": true,
  "return_heatmap": true,
  "location": true
}

Yanıt parametreleri

Parametre	Tür	Açıklama
code	integer	API yanıt kodları için referans
request_id	string	Entegrasyonunuzu oluşturmak ve hata ayıklamak için bu örnekleri kullanın
data.detection_result	"fake" \| "real"	Tahrifat sonucu: "fake" tahrifat tespit edildiğini, "real" ise tahrifat tespit edilmediğini gösterir.
data.tampered_proportion	number \| null	Tahrifat güven skoru, detect_proportion = true olduğunda döndürülür.
data.heatmap	string \| null	Tahrif edilmiş bölgelerin Base64 heatmap’i, return_heatmap = true olduğunda döndürülür.
data.tampered_location	array	Şüpheli bölge koordinatları dizisi, probability restrict_probability değerine eşit veya büyük olduğunda döndürülür. Her öğe left, top, width, height ve probability içerir.

Örnek Yanıtlar

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "detection_result": "fake",
    "tampered_proportion": 0.82,
    "heatmap": "<BASE64_HEATMAP>",
    "tampered_location": [
      { "left": 124, "top": 86, "width": 220, "height": 74, "probability": 0.91 }
    ]
  }
}

Hata Kodları

400INVALID_REQUESTAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

401INVALID_API_KEYAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

402CREDITS_EXHAUSTEDAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

413PAYLOAD_TOO_LARGEAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

415UNSUPPORTED_IMAGEAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

502UPSTREAM_ERRORAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

504UPSTREAM_TIMEOUTAPI messages üretimdeki yanıtlarla tam eşleşmesi için upstream servisin ham değerleri olarak gösterilir.

Kod Örnekleri

curl -X POST "https://api.imgauth.com/v1/document-fraud-detection" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "detect_proportion": true,
  "return_heatmap": true,
  "location": true
}'