Ανίχνευση απάτης εγγράφων API

Εισαγωγή API

Η τεχνολογία Τεχνητής Νοημοσύνης εξειδικευμένη στον εντοπισμό πλαστογραφίας εικόνων έχει γίνει πιο εύκολη από ποτέ χρησιμοποιώντας το API του ImgAuth.com. Με λίγες μόνο γραμμές κώδικα, μπορείτε να φέρετε αυτή την τεχνολογία στην εφαρμογή σας.

Παράμετροι Αιτήματος: Δεδομένα εικόνας κωδικοποιημένα σε Base64 και έπειτα URL-encoded. Μέγιστο 10 MB. Η μικρότερη πλευρά τουλάχιστον 512 px και η μεγαλύτερη πλευρά το πολύ 8192 px. Υποστηρίζει jpg/jpeg/png/bmp. Δώστε image ή url.
Παράμετροι απόκρισης: Αναφορά πεδίων απόκρισης API

Εισαγωγή API

οικονομικές ομάδες ελέγχουν τιμολόγια και αποδείξεις
ομάδες HR ελέγχουν πιστοποιητικά και σαρώσεις
ασφαλιστικές ομάδες ελέγχουν έγγραφα αξιώσεων

Πιστοποίηση

Αντικαταστήστε το {your-api-domain} με το endpoint API που εμφανίζεται στον πίνακα λογαριασμού σας.

Πιστοποιήστε τα αιτήματα με το endpoint API του λογαριασμού σας και ένα Bearer token. Μετά την αγορά πιστώσεων API, μπορείτε να δείτε το endpoint και το token από τον πίνακα λογαριασμού σας. Κρατήστε το token μυστικό και μην το κάνετε ποτέ commit σε δημόσια αποθετήρια.

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

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

Παράμετροι Αιτήματος

Παράμετρος	Τύπος	✓	Περιγραφή
image	string	✓	Δεδομένα εικόνας κωδικοποιημένα σε Base64 και έπειτα URL-encoded. Μέγιστο 10 MB. Η μικρότερη πλευρά τουλάχιστον 512 px και η μεγαλύτερη πλευρά το πολύ 8192 px. Υποστηρίζει jpg/jpeg/png/bmp. Δώστε image ή url.
detect_proportion	boolean	—	Ορίζει αν θα επιστραφεί ο βαθμός εμπιστοσύνης της παραποίησης. Προεπιλογή: false. true επιστρέφει τον βαθμό, false όχι.
return_heatmap	boolean	—	Ορίζει αν θα επιστραφεί heatmap πλαστογράφησης. Προεπιλογή: false. true επιστρέφει Base64 heatmap, false όχι.
location	boolean	—	Χρησιμοποιήστε αυτά τα παραδείγματα για να δημιουργήσετε και να debug την ενσωμάτωσή σας

Παράδειγμα HTTP Αίτημα

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

Παράμετροι απόκρισης

Παράμετρος	Τύπος	Περιγραφή
code	integer	Αναφορά για κωδικούς απάντησης API
request_id	string	Χρησιμοποιήστε αυτά τα παραδείγματα για να δημιουργήσετε και να debug την ενσωμάτωσή σας
data.detection_result	"fake" \| "real"	Αποτέλεσμα παραποίησης: το "fake" σημαίνει ότι εντοπίστηκε παραποίηση, ενώ το "real" ότι δεν εντοπίστηκε παραποίηση.
data.tampered_proportion	number \| null	Βαθμός εμπιστοσύνης παραποίησης, επιστρέφεται όταν detect_proportion = true.
data.heatmap	string \| null	Base64 heatmap των παραποιημένων περιοχών, επιστρέφεται όταν return_heatmap = true.
data.tampered_location	array	Πίνακας συντεταγμένων ύποπτων περιοχών, επιστρέφεται όταν το probability είναι μεγαλύτερο ή ίσο με το restrict_probability. Κάθε στοιχείο περιλαμβάνει left, top, width, height και probability.

Παραδείγματα Απαντήσεων

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

Κωδικοί Σφάλματος

400INVALID_REQUESTΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

401INVALID_API_KEYΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

402CREDITS_EXHAUSTEDΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

403API_KEY_INACTIVE / API_KEY_EXPIREDΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

413PAYLOAD_TOO_LARGEΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

415UNSUPPORTED_IMAGEΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

502UPSTREAM_ERRORΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

504UPSTREAM_TIMEOUTΤα API messages εμφανίζονται ως ακατέργαστες τιμές της upstream υπηρεσίας ώστε να ταιριάζουν ακριβώς με τις απαντήσεις παραγωγής.

Παραδείγματα Κώδικα

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