Dokumentbedrägeridetektion API

API Introduktion

Artificiell intelligens-teknologin specialiserad på bildförfalskningsdetektering har gjorts enklare än någonsin med hjälp av ImgAuth.com API. Med bara några rader kod kan du ta med denna teknik i din applikation.

Begäran Parametrar: Base64-kodad bilddata som sedan URL-kodas. Max 10 MB. Kortaste sidan minst 512 px och längsta sidan högst 8192 px. Stöder jpg/jpeg/png/bmp. Ange image eller url.
Svarparametrar: Referens för API-svarsfält

API Introduktion

ekonomiteam granskar fakturor och kvitton
HR-team granskar certifikat och skanningar
försäkringsteam granskar skadehandlingar

Autentisering

Ersätt {your-api-domain} med API-endpointen som visas i ditt kontopanel.

Autentisera förfrågningar med ditt kontos API-endpoint och en Bearer-token. Efter att du köpt API-krediter kan du se endpoint och token i ditt kontopanel. Håll din token hemlig och lägg den aldrig i publika repositorier.

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

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

Begäran Parametrar

Parameter	Typ	✓	Beskrivning
image	string	✓	Base64-kodad bilddata som sedan URL-kodas. Max 10 MB. Kortaste sidan minst 512 px och längsta sidan högst 8192 px. Stöder jpg/jpeg/png/bmp. Ange image eller url.
detect_proportion	boolean	—	Anger om tillförlitlighetspoängen för manipulering ska returneras. Standard: false. true returnerar poängen, false gör det inte.
return_heatmap	boolean	—	Anger om ett förfalsknings-heatmap ska returneras. Standard: false. true returnerar ett Base64-heatmap, false gör det inte.
location	boolean	—	Använd dessa exempel för att bygga och felsöka din integration

Exempel HTTP Begäran

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

Svarparametrar

Parameter	Typ	Beskrivning
code	integer	Referens för API-svarkoder
request_id	string	Använd dessa exempel för att bygga och felsöka din integration
data.detection_result	"fake" \| "real"	Manipuleringsresultat: "fake" betyder att manipulering upptäcktes och "real" betyder att ingen manipulering upptäcktes.
data.tampered_proportion	number \| null	Tillförlitlighetspoäng för manipulering, returneras när detect_proportion = true.
data.heatmap	string \| null	Base64-heatmap för manipulerade områden, returneras när return_heatmap = true.
data.tampered_location	array	Array med koordinater för misstänkta områden, returneras när probability är större än eller lika med restrict_probability. Varje post innehåller left, top, width, height och probability.

Exempel Svar

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

Felkoder

400INVALID_REQUESTAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

401INVALID_API_KEYAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

402CREDITS_EXHAUSTEDAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

413PAYLOAD_TOO_LARGEAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

415UNSUPPORTED_IMAGEAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

502UPSTREAM_ERRORAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

504UPSTREAM_TIMEOUTAPI messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

Kodexempel

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