זיהוי הונאת מסמכים API

מבוא API

טכנולוגיית הבינה המלאכותית המתמחה בזיהוי זיוף תמונות הפכה קלה מתמיד באמצעות API של ImgAuth.com. עם כמה שורות קוד בלבד, תוכל להביא את הטכנולוגיה הזו ליישום שלך.

פרמטרי בקשה: נתוני תמונה המקודדים ב-Base64 ולאחר מכן ב-URL-encode. מקסימום 10 MB. הצד הקצר לפחות 512 px והצד הארוך לכל היותר 8192 px. תומך ב-jpg/jpeg/png/bmp. יש לספק image או url.
פרמטרי תגובה: מדריך לשדות תגובת API

מבוא API

צוותי כספים בודקים חשבוניות וקבלות
צוותי משאבי אנוש בודקים תעודות וסריקות
צוותי ביטוח בודקים מסמכי תביעה

אימות

החליפו את {your-api-domain} ב-endpoint ה-API שמופיע בלוח הבקרה של החשבון.

אמתו בקשות באמצעות endpoint ה-API של החשבון שלכם וטוקן Bearer. לאחר רכישת קרדיטים ל-API תוכלו לראות את ה-endpoint והטוקן בלוח הבקרה של החשבון. שמרו על הטוקן בסוד ואל תבצעו לו 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-encode. מקסימום 10 MB. הצד הקצר לפחות 512 px והצד הארוך לכל היותר 8192 px. תומך ב-jpg/jpeg/png/bmp. יש לספק image או url.
detect_proportion	boolean	—	קובע האם להחזיר את ציון הביטחון של המניפולציה. ברירת מחדל: false. true מחזיר את הציון, false לא.
return_heatmap	boolean	—	קובע האם להחזיר heatmap של זיוף. ברירת מחדל: false. true מחזיר heatmap ב-Base64, false לא.
location	boolean	—	השתמש בדוגמאות אלה כדי לבנות ולאבחן את האינטגרציה שלך

דוגמת בקשה HTTP

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

פרמטרי תגובה

פרמטר	סוג	תיאור
code	integer	הפנייה לקודי תגובת API
request_id	string	השתמש בדוגמאות אלה כדי לבנות ולאבחן את האינטגרציה שלך
data.detection_result	"fake" \| "real"	תוצאת המניפולציה: "fake" פירושו שזוהתה מניפולציה, ו-"real" פירושו שלא זוהתה מניפולציה.
data.tampered_proportion	number \| null	ציון הביטחון של המניפולציה, מוחזר כאשר detect_proportion = true.
data.heatmap	string \| null	Heatmap ב-Base64 של האזורים שעברו מניפולציה, מוחזר כאשר 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_REQUESTAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

401INVALID_API_KEYAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

402CREDITS_EXHAUSTEDAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

413PAYLOAD_TOO_LARGEAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

415UNSUPPORTED_IMAGEAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

502UPSTREAM_ERRORAPI messages מוצגים כערכי upstream גולמיים כדי להתאים בדיוק לתגובות הייצור.

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