Wykrywanie oszustw dokumentowych API

Wprowadzenie do API

Technologia sztucznej inteligencji specjalizująca się w wykrywaniu fałszerstw została ułatwiona bardziej niż kiedykolwiek dzięki użyciu API ImgAuth.com. Za pomocą zaledwie kilku linii kodu możesz wprowadzić tę technologię do swojej aplikacji.

Parametry Żądania: Dane obrazu zakodowane w Base64, a następnie URL-encoded. Maksymalnie 10 MB. Krótszy bok co najmniej 512 px, dłuższy bok najwyżej 8192 px. Obsługuje jpg/jpeg/png/bmp. Podaj image lub url.
Parametry odpowiedzi: Opis pól odpowiedzi API

Wprowadzenie do API

zespoły finansowe sprawdzają faktury i paragony
HR sprawdza certyfikaty i skany
ubezpieczyciele sprawdzają dokumenty roszczeń

Uwierzytelnianie

Zastąp {your-api-domain} endpointem API pokazanym w panelu konta.

Uwierzytelniaj żądania za pomocą endpointu API swojego konta i tokenu Bearer. Po zakupie kredytów API możesz zobaczyć endpoint i token w panelu konta. Zachowaj token w tajemnicy i nigdy nie umieszczaj go w publicznych repozytoriach.

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

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

Parametry Żądania

Parametr	Typ	✓	Opis
image	string	✓	Dane obrazu zakodowane w Base64, a następnie URL-encoded. Maksymalnie 10 MB. Krótszy bok co najmniej 512 px, dłuższy bok najwyżej 8192 px. Obsługuje jpg/jpeg/png/bmp. Podaj image lub url.
detect_proportion	boolean	—	Określa, czy zwrócić poziom pewności manipulacji. Domyślnie: false. true zwraca wynik, false nie.
return_heatmap	boolean	—	Określa, czy zwrócić heatmapę fałszerstwa. Domyślnie: false. true zwraca heatmapę Base64, false jej nie zwraca.
location	boolean	—	Użyj tych przykładów do budowania i debugowania integracji

Przykładowe Żądanie HTTP

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

Parametry odpowiedzi

Parametr	Typ	Opis
code	integer	Referencja dla kodów odpowiedzi API
request_id	string	Użyj tych przykładów do budowania i debugowania integracji
data.detection_result	"fake" \| "real"	Wynik manipulacji: "fake" oznacza wykrytą manipulację, a "real" oznacza brak wykrytej manipulacji.
data.tampered_proportion	number \| null	Poziom pewności manipulacji, zwracany gdy detect_proportion = true.
data.heatmap	string \| null	Heatmapa Base64 zmanipulowanych obszarów, zwracana gdy return_heatmap = true.
data.tampered_location	array	Tablica współrzędnych podejrzanych obszarów, zwracana gdy probability jest większe lub równe restrict_probability. Każdy element zawiera left, top, width, height oraz probability.

Przykładowe Odpowiedzi

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

Kody Błędów

400INVALID_REQUESTAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

401INVALID_API_KEYAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

402CREDITS_EXHAUSTEDAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

413PAYLOAD_TOO_LARGEAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

415UNSUPPORTED_IMAGEAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

502UPSTREAM_ERRORAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

504UPSTREAM_TIMEOUTAPI messages są wyświetlane jako surowe wartości usługi upstream, aby dokładnie odpowiadały odpowiedziom z produkcji.

Przykłady Kodu

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