Asiakirjapetosten tunnistus API

API Johdanto

Tekoälyteknologia, joka on erikoistunut kuvaväärennösten havaitsemiseen, on tehty helpommaksi kuin koskaan ImgAuth.com API:n avulla. Vain muutamalla koodirivillä voit tuoda tämän teknologian sovellukseesi.

Pyyntöparametrit: Base64-koodattu kuvatieto, joka URL-koodataan. Enintään 10 MB. Lyhin sivu vähintään 512 px ja pisin sivu enintään 8192 px. Tukee jpg/jpeg/png/bmp. Anna image tai url.
Vastausparametrit: API-vastauskenttien viite

API Johdanto

taloustiimit tarkistavat laskuja ja kuitteja
HR-tiimit tarkistavat todistuksia ja skannauksia
vakuutustiimit tarkistavat korvausasiakirjoja

Todennus

Korvaa {your-api-domain} tilisi hallintapaneelissa näkyvällä API-päätepisteellä.

Todennat pyynnöt tilisi API-päätepisteellä ja Bearer-tokenilla. API-krediittien oston jälkeen voit nähdä päätepisteen ja tokenin tilisi hallintapaneelissa. Pidä token salassa äläkä koskaan committoi sitä julkisiin repositorioihin.

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

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

Pyyntöparametrit

Parametri	Tyyppi	✓	Kuvaus
image	string	✓	Base64-koodattu kuvatieto, joka URL-koodataan. Enintään 10 MB. Lyhin sivu vähintään 512 px ja pisin sivu enintään 8192 px. Tukee jpg/jpeg/png/bmp. Anna image tai url.
detect_proportion	boolean	—	Määrittää palautetaanko manipuloinnin luottamusarvo. Oletus: false. true palauttaa arvon, false ei palauta.
return_heatmap	boolean	—	Määrittää palautetaanko väärennös-heatmap. Oletus: false. true palauttaa Base64-heatmapin, false ei palauta.
location	boolean	—	Käytä näitä esimerkkejä rakentaaksesi ja debugataksesi integraatiosi

Esimerkki HTTP-pyyntö

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

Vastausparametrit

Parametri	Tyyppi	Kuvaus
code	integer	Viite API-vastauskoodeille
request_id	string	Käytä näitä esimerkkejä rakentaaksesi ja debugataksesi integraatiosi
data.detection_result	"fake" \| "real"	Manipulointitulos: "fake" tarkoittaa, että manipulointi havaittiin, ja "real" tarkoittaa, ettei manipulointia havaittu.
data.tampered_proportion	number \| null	Manipuloinnin luottamusarvo, palautetaan kun detect_proportion = true.
data.heatmap	string \| null	Manipuloitujen alueiden Base64-heatmap, palautetaan kun return_heatmap = true.
data.tampered_location	array	Taulukko epäilyttävien alueiden koordinaateista, palautetaan kun probability on suurempi tai yhtä suuri kuin restrict_probability. Jokainen alkio sisältää left, top, width, height ja probability.

Esimerkki vastaukset

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

Virhekoodit

400INVALID_REQUESTAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

401INVALID_API_KEYAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

402CREDITS_EXHAUSTEDAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

413PAYLOAD_TOO_LARGEAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

415UNSUPPORTED_IMAGEAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

502UPSTREAM_ERRORAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

504UPSTREAM_TIMEOUTAPI messages näytetään upstream-palvelun raaka-arvoina, jotta ne vastaavat täsmälleen tuotantovastauksia.

Koodiesimerkit

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