Detectie van documentfraude API

API Introductie

De kunstmatige intelligentie technologie gespecialiseerd in vervalsingsdetectie is gemakkelijker gemaakt dan ooit met behulp van de ImgAuth.com API. Met slechts een paar regels code kunt u deze technologie in uw applicatie brengen.

Verzoek Parameters: In Base64 gecodeerde afbeeldingsgegevens, daarna URL-encoded. Maximaal 10 MB. Kortste zijde minimaal 512 px en langste zijde maximaal 8192 px. Ondersteunt jpg/jpeg/png/bmp. Geef image of url op.
Responsparameters: Referentie voor API-responsvelden

API Introductie

financeteams beoordelen facturen en bonnen
HR-teams beoordelen certificaten en scans
verzekeringsteams beoordelen claimdocumenten

Authenticatie

Vervang {your-api-domain} door het API-endpoint dat in je accountdashboard wordt weergegeven.

Authenticeer verzoeken met het API-endpoint van je account en een Bearer-token. Na aankoop van API-credits kun je je endpoint en token bekijken in je accountdashboard. Houd je token geheim en commit het nooit naar openbare repositories.

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

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

Verzoek Parameters

Parameter	Type	✓	Beschrijving
image	string	✓	In Base64 gecodeerde afbeeldingsgegevens, daarna URL-encoded. Maximaal 10 MB. Kortste zijde minimaal 512 px en langste zijde maximaal 8192 px. Ondersteunt jpg/jpeg/png/bmp. Geef image of url op.
detect_proportion	boolean	—	Geeft aan of de betrouwbaarheidsscore van manipulatie moet worden geretourneerd. Standaard: false. true retourneert de score, false niet.
return_heatmap	boolean	—	Geeft aan of een vervalsings-heatmap moet worden geretourneerd. Standaard: false. true retourneert een Base64-heatmap, false niet.
location	boolean	—	Gebruik deze voorbeelden om uw integratie te bouwen en te debuggen

Voorbeeld HTTP Verzoek

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

Responsparameters

Parameter	Type	Beschrijving
code	integer	Referentie voor API-antwoordcodes
request_id	string	Gebruik deze voorbeelden om uw integratie te bouwen en te debuggen
data.detection_result	"fake" \| "real"	Manipulatieresultaat: "fake" betekent dat manipulatie is gedetecteerd en "real" betekent dat er geen manipulatie is gedetecteerd.
data.tampered_proportion	number \| null	Betrouwbaarheidsscore van manipulatie, geretourneerd wanneer detect_proportion = true.
data.heatmap	string \| null	Base64-heatmap van gemanipuleerde gebieden, geretourneerd wanneer return_heatmap = true.
data.tampered_location	array	Array met coördinaten van verdachte gebieden, geretourneerd wanneer probability groter dan of gelijk aan restrict_probability is. Elk item bevat left, top, width, height en probability.

Voorbeeld Antwoorden

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

Foutcodes

400INVALID_REQUESTAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

401INVALID_API_KEYAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

402CREDITS_EXHAUSTEDAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

413PAYLOAD_TOO_LARGEAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

415UNSUPPORTED_IMAGEAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

502UPSTREAM_ERRORAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

504UPSTREAM_TIMEOUTAPI messages worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.

Code Voorbeelden

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