كشف الاحتيال في المستندات API

مقدمة API

أصبحت تقنية الذكاء الاصطناعي المتخصصة في كشف التزوير أسهل من أي وقت مضى باستخدام API الخاص بـ ImgAuth.com. ببضعة أسطر من الكود فقط، يمكنك إحضار هذه التقنية إلى تطبيقك.

معاملات الطلب: بيانات صورة مشفرة بـ Base64 ثم مشفرة بعنوان URL. الحد الأقصى 10 MB. أقصر ضلع لا يقل عن 512 px وأطول ضلع لا يزيد عن 8192 px. يدعم jpg/jpeg/png/bmp. قدّم image أو url.
معلمات الاستجابة: مرجع حقول استجابة API

مقدمة API

فرق المالية تراجع الفواتير والإيصالات
فرق الموارد البشرية تراجع الشهادات والسجلات الممسوحة
فرق التأمين تراجع مستندات المطالبات

المصادقة

استبدل {your-api-domain} بنقطة نهاية API الظاهرة في لوحة حسابك.

قم بمصادقة الطلبات باستخدام نقطة نهاية API الخاصة بحسابك ورمز Bearer. بعد شراء أرصدة API يمكنك عرض نقطة النهاية والرمز من لوحة حسابك. حافظ على سرية الرمز ولا تقم بإضافته إلى مستودعات عامة.

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

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

معاملات الطلب

المعامل	النوع	✓	الوصف
image	string	✓	بيانات صورة مشفرة بـ Base64 ثم مشفرة بعنوان URL. الحد الأقصى 10 MB. أقصر ضلع لا يقل عن 512 px وأطول ضلع لا يزيد عن 8192 px. يدعم jpg/jpeg/png/bmp. قدّم image أو url.
detect_proportion	boolean	—	هل يتم إرجاع درجة الثقة في التلاعب. الافتراضي false. القيمة true تعيد الدرجة، وfalse لا تعيدها.
return_heatmap	boolean	—	هل يتم إرجاع خريطة حرارية للتزوير. الافتراضي false. القيمة true تعيد خريطة 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	خريطة حرارية 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_REQUESTيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

401INVALID_API_KEYيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

402CREDITS_EXHAUSTEDيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

403API_KEY_INACTIVE / API_KEY_EXPIREDيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

413PAYLOAD_TOO_LARGEيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

415UNSUPPORTED_IMAGEيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

502UPSTREAM_ERRORيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

504UPSTREAM_TIMEOUTيتم عرض API messages كقيم خام من الخدمة العليا حتى تطابق الاستجابات الفعلية في بيئة الإنتاج.

أمثلة الكود

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