Detectarea fraudei documentare API

Introducere API

Tehnologia de Inteligență Artificială specializată în detectarea falsurilor a fost făcută mai ușoară ca niciodată folosind API-ul ImgAuth.com. Cu doar câteva linii de cod, puteți aduce această tehnologie în aplicația dvs.

Parametri de Cerere: Date de imagine codificate Base64 și apoi URL-encode. Maximum 10 MB. Latura cea mai scurtă de cel puțin 512 px, iar latura cea mai lungă de cel mult 8192 px. Suportă jpg/jpeg/png/bmp. Furnizează image sau url.
Parametri de răspuns: Referință pentru câmpurile răspunsului API

Introducere API

echipe financiare verifică facturi și chitanțe
HR verifică certificate și scanări
asigurătorii verifică documente de daună

Autentificare

Înlocuiește {your-api-domain} cu endpoint-ul API afișat în panoul contului tău.

Autentifică solicitările cu endpoint-ul API al contului tău și un token Bearer. După cumpărarea creditelor API, poți vedea endpoint-ul și token-ul în panoul contului. Păstrează token-ul secret și nu îl publica niciodată în depozite publice.

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

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

Parametri de Cerere

Parametru	Tip	✓	Descriere
image	string	✓	Date de imagine codificate Base64 și apoi URL-encode. Maximum 10 MB. Latura cea mai scurtă de cel puțin 512 px, iar latura cea mai lungă de cel mult 8192 px. Suportă jpg/jpeg/png/bmp. Furnizează image sau url.
detect_proportion	boolean	—	Indică dacă trebuie returnat scorul de încredere al manipulării. Implicit: false. true returnează scorul, false îl omite.
return_heatmap	boolean	—	Indică dacă trebuie returnat un heatmap de falsificare. Implicit: false. true returnează un heatmap Base64, false îl omite.
location	boolean	—	Folosiți aceste exemple pentru a construi și depana integrarea dvs.

Exemplu Cerere HTTP

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

Parametri de răspuns

Parametru	Tip	Descriere
code	integer	Referință pentru codurile de răspuns API
request_id	string	Folosiți aceste exemple pentru a construi și depana integrarea dvs.
data.detection_result	"fake" \| "real"	Rezultatul manipulării: "fake" înseamnă că s-a detectat falsificare, iar "real" înseamnă că nu s-a detectat falsificare.
data.tampered_proportion	number \| null	Scorul de încredere al manipulării, returnat când detect_proportion = true.
data.heatmap	string \| null	Heatmap Base64 al regiunilor falsificate, returnat când return_heatmap = true.
data.tampered_location	array	Array cu coordonatele regiunilor suspecte, returnat când probability este mai mare sau egală cu restrict_probability. Fiecare element include left, top, width, height și probability.

Exemple de Răspuns

{
  "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 }
    ]
  }
}

Coduri de Eroare

400INVALID_REQUESTAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

401INVALID_API_KEYAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

402CREDITS_EXHAUSTEDAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

413PAYLOAD_TOO_LARGEAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

415UNSUPPORTED_IMAGEAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

502UPSTREAM_ERRORAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

504UPSTREAM_TIMEOUTAPI messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

Exemple de Cod

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
}'