Rilevamento frodi documentali API

Introduzione API

La tecnologia di Intelligenza Artificiale specializzata nel rilevamento falsificazioni è stata resa più facile che mai utilizzando l'API ImgAuth.com. Con solo poche righe di codice, puoi portare questa tecnologia nella tua applicazione.

Parametri di Richiesta: Dati immagine codificati in Base64 e poi URL-encoded. Massimo 10 MB. Lato più corto di almeno 512 px e lato più lungo di massimo 8192 px. Supporta jpg/jpeg/png/bmp. Fornisci image oppure url.
Parametri di risposta: Riferimento dei campi di risposta API

Introduzione API

team finance revisionano fatture e ricevute
team HR revisionano certificati e scansioni
team assicurativi revisionano documenti di sinistro

Autenticazione

Sostituisci {your-api-domain} con l’endpoint API mostrato nella dashboard del tuo account.

Autentica le richieste con l’endpoint API del tuo account e un token Bearer. Dopo l’acquisto dei crediti API, puoi vedere endpoint e token nella dashboard del tuo account. Mantieni segreto il token e non pubblicarlo mai in repository pubblici.

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

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

Parametri di Richiesta

Parametro	Tipo	✓	Descrizione
image	string	✓	Dati immagine codificati in Base64 e poi URL-encoded. Massimo 10 MB. Lato più corto di almeno 512 px e lato più lungo di massimo 8192 px. Supporta jpg/jpeg/png/bmp. Fornisci image oppure url.
detect_proportion	boolean	—	Indica se restituire il punteggio di confidenza della manomissione. Predefinito: false. true restituisce il punteggio, false lo omette.
return_heatmap	boolean	—	Indica se restituire una heatmap di falsificazione. Predefinito: false. true restituisce una heatmap Base64, false la omette.
location	boolean	—	Usa questi esempi per costruire e debuggare la tua integrazione

Esempio Richiesta HTTP

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

Parametri di risposta

Parametro	Tipo	Descrizione
code	integer	Riferimento per i codici di risposta API
request_id	string	Usa questi esempi per costruire e debuggare la tua integrazione
data.detection_result	"fake" \| "real"	Risultato della manomissione: "fake" indica manipolazione rilevata, "real" indica nessuna manipolazione rilevata.
data.tampered_proportion	number \| null	Punteggio di confidenza della manomissione, restituito quando detect_proportion = true.
data.heatmap	string \| null	Heatmap Base64 delle regioni manomesse, restituita quando return_heatmap = true.
data.tampered_location	array	Array delle coordinate delle regioni sospette, restituito quando probability è maggiore o uguale a restrict_probability. Ogni elemento include left, top, width, height e probability.

Esempi di Risposta

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

Codici di Errore

400INVALID_REQUESTGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

401INVALID_API_KEYGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

402CREDITS_EXHAUSTEDGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

403API_KEY_INACTIVE / API_KEY_EXPIREDGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

413PAYLOAD_TOO_LARGEGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

415UNSUPPORTED_IMAGEGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

502UPSTREAM_ERRORGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

504UPSTREAM_TIMEOUTGli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.

Esempi di Codice

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