Détection de fraude documentaire API

Introduction API

La technologie d'Intelligence Artificielle spécialisée dans la détection de falsification d'image a été rendue plus facile que jamais en utilisant l'API ImgAuth.com. Avec seulement quelques lignes de code, vous pouvez intégrer cette technologie dans votre application.

Paramètres de Requête: Données d’image encodées en Base64 puis URL-encodées. Maximum 10 MB. Côté le plus court au moins 512 px, côté le plus long au plus 8192 px. Prend en charge jpg/jpeg/png/bmp. Fournissez image ou url.
Paramètres de réponse: Référence des champs de réponse API

Introduction API

équipes finance examinant factures et reçus
équipes RH examinant certificats et scans
assureurs examinant dossiers de sinistre

Authentification

Remplacez {your-api-domain} par l’endpoint API affiché dans le tableau de bord de votre compte.

Authentifiez les requêtes avec l’endpoint API de votre compte et un jeton Bearer. Après l’achat de crédits API, vous pouvez voir votre endpoint et votre jeton dans le tableau de bord de votre compte. Gardez votre jeton secret et ne le publiez jamais dans un dépôt public.

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

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

Paramètres de Requête

Paramètre	Type	✓	Description
image	string	✓	Données d’image encodées en Base64 puis URL-encodées. Maximum 10 MB. Côté le plus court au moins 512 px, côté le plus long au plus 8192 px. Prend en charge jpg/jpeg/png/bmp. Fournissez image ou url.
detect_proportion	boolean	—	Indique s’il faut renvoyer le score de confiance de falsification. Par défaut : false. true renvoie le score, false l’omet.
return_heatmap	boolean	—	Indique s’il faut renvoyer une heatmap de falsification. Par défaut : false. true renvoie une heatmap Base64, false ne la renvoie pas.
location	boolean	—	Utilisez ces exemples pour construire et déboguer votre intégration

Exemple de Requête HTTP

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

Paramètres de réponse

Paramètre	Type	Description
code	integer	Référence pour les codes de réponse API
request_id	string	Utilisez ces exemples pour construire et déboguer votre intégration
data.detection_result	"fake" \| "real"	Résultat de falsification : "fake" signifie qu’une manipulation a été détectée, "real" qu’aucune manipulation n’a été détectée.
data.tampered_proportion	number \| null	Score de confiance de falsification, renvoyé lorsque detect_proportion = true.
data.heatmap	string \| null	Heatmap Base64 des zones falsifiées, renvoyée lorsque return_heatmap = true.
data.tampered_location	array	Tableau des coordonnées des zones suspectes, renvoyé lorsque probability est supérieure ou égale à restrict_probability. Chaque élément contient left, top, width, height et probability.

Exemples de Réponse

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

Codes d'Erreur

400INVALID_REQUESTLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

401INVALID_API_KEYLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

402CREDITS_EXHAUSTEDLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

403API_KEY_INACTIVE / API_KEY_EXPIREDLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

413PAYLOAD_TOO_LARGELes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

415UNSUPPORTED_IMAGELes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

502UPSTREAM_ERRORLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

504UPSTREAM_TIMEOUTLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

Exemples de Code

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