واجهة API لاكتشاف تزوير الصور
وصول المطورين

اكتشف التلاعب في المستندات والصور عبر واجهة REST API جاهزة للإنتاج.

أمثلة الطلب والاستجابة

استخدم هذه الأمثلة لبناء وتصحيح التكامل الخاص بك

مثال طلب HTTP

POST https://{your-api-domain}/forgery_detection
الرؤوس:
  Authorization: Bearer {YOUR_API_TOKEN}
  Content-Type: application/json; charset=UTF-8

Body:
{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "return_heatmap": "false",
  "detect_proportion": "false",
  "restrict_probability": "0.8"
}

أمثلة الاستجابة

استجابة ناجحة

عندما يكون الطلب صالحًا وتتم معالجة الصورة بنجاح، تعيد API الحقل detection_result لتوضيح ما إذا كانت الصورة مزورة (fake) أو أصلية (real)، ويمكنها أيضًا إعادة درجة الثقة والخريطة الحرارية والإحداثيات عند الطلب.

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
  "code": 0,
  "data": {
    "detection_result": "fake",
    "tampered_proportion": 0.000587,
    "heatmap": "<BASE64_HEATMAP_IMAGE>",
    "tampered_location": [
      {
        "left": 100,
        "top": 200,
        "width": 150,
        "height": 100,
        "probability": 0.95
      }
    ]
  },
  "message": "Success"
}

استجابة خطأ تجاري

عندما يبلغ الخدمة المصدر عن خطأ تجاري، يعيد API خطأ = "API_ERROR" ورمز غير صفري. يمكنك تعيين هذا الرمز باستخدام جدول رموز الخطأ أدناه.

HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8

{
  "error": "API_ERROR",
  "code": 1004,
  "message": "Image size error. Please ensure the image is less than 5MB and the longest side is less than 4000px."
}

مقدمة API

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

اختر أرصدة API

اختر باقة أرصدة API المناسبة لحجم التكامل لديك

احصل على وصول API

بعد الشراء يمكنك عرض مفتاح API ونقطة النهاية من لوحة حسابك

استخدام أمثلة الكود

استخدم أمثلة الكود التالية للبدء بسرعة

الانطلاق للإنتاج

راقب الاستخدام وعدّل المعلمات وانتقل إلى بيئة الإنتاج

المصادقة

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

نقطة نهاية API

POST https://{your-api-domain}/forgery_detection

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

الرؤوس

التفويض:

Bearer {YOUR_API_TOKEN}

استبدل {YOUR_API_TOKEN} برمز Bearer الظاهر في لوحة حسابك. حافظ على سريته ولا تقم بإضافته إلى مستودعات عامة.

نوع المحتوى:

application/json; charset=UTF-8

أمثلة الكود

ابدأ بسرعة مع أمثلة الكود الخاصة بنا

#!/usr/bin/env bash

set -euo pipefail

API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"
IMAGE_FILE="${1:-testpaper.jpg}"

BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')

read -r -d '' JSON_BODY <<EOF || true
{
  "image": "$BASE64_IMAGE",
  "return_heatmap": "false",
  "detect_proportion": "false",
  "restrict_probability": "0.8"
}
EOF

curl -X POST "${API_DOMAIN}${API_PATH}" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json; charset=UTF-8" \
  -d "$JSON_BODY" \
  -o response.json \
  -s -w "\nHTTP status: %{http_code}\n"

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

قم بتكوين طلبات API الخاصة بك باستخدام هذه المعاملات

المعامل	النوع	الوصف
image	string	بيانات صورة مشفرة بـ Base64 ثم مشفرة بعنوان URL. الحد الأقصى 10 MB. أقصر ضلع لا يقل عن 512 px وأطول ضلع لا يزيد عن 8192 px. يدعم jpg/jpeg/png/bmp. قدّم image أو url.
url	string	رابط الصورة الكامل بطول لا يتجاوز 1024 بايت. يجب أن يبقى حجم الصورة بعد الترميز أقل من 10 MB. أقصر ضلع لا يقل عن 512 px وأطول ضلع لا يزيد عن 8192 px. يدعم jpg/jpeg/png/bmp. قدّم image أو url وعطّل حماية الربط المباشر.
return_heatmap	string	هل يتم إرجاع خريطة حرارية للتزوير. الافتراضي false. القيمة true تعيد خريطة Base64، وfalse لا تعيدها.
detect_proportion	string	هل يتم إرجاع درجة الثقة في التلاعب. الافتراضي false. القيمة true تعيد الدرجة، وfalse لا تعيدها.
restrict_probability	string	الحد الأدنى لإرجاع إحداثيات التزوير. النطاق من 0.1 إلى 1 مع منزلة عشرية واحدة. الافتراضي 0.8. لا يتم إرجاع tampered_location إلا إذا كانت probability أكبر من أو تساوي هذا الحد.

معلمات الاستجابة

مرجع حقول استجابة API

المعلمة	النوع	الوصف
detection_result	string	نتيجة التلاعب: "fake" تعني اكتشاف تزوير، و"real" تعني عدم اكتشاف تزوير.
tampered_proportion	float	درجة الثقة في التلاعب، وتُعاد عندما يكون detect_proportion = true.
heatmap	string	خريطة حرارية Base64 للمناطق المتلاعب بها، وتُعاد عندما يكون return_heatmap = true.
tampered_location	array	مصفوفة إحداثيات المناطق المشبوهة، وتُعاد عندما تكون probability أكبر من أو تساوي restrict_probability. يحتوي كل عنصر على left وtop وwidth وheight وprobability.
left	uint32	الإحداثي الأفقي للزاوية العلوية اليسرى للمنطقة المشبوهة.
top	uint32	الإحداثي العمودي للزاوية العلوية اليسرى للمنطقة المشبوهة.
width	uint32	عرض المنطقة المشبوهة.
height	uint32	ارتفاع المنطقة المشبوهة.
probability	float	درجة الثقة لهذه المنطقة المشبوهة.

رموز الخطأ

مرجع لرموز استجابة API

رمز الخطأ	رسالة الخطأ
0	success
1000	body error
1001	param error
1002	content type error
1003	image not exists
1004	image size error
1005	image format error
1006	invalid signature
1007	body size error
1008	no authorization
2000	server unknown error
2001	server timeout
2003	no content recognition
2004	validate data error
3000	remote server error
4000	base server error

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

خطط تسعير API

أرخص من باقات الرصيد لمرة واحدة. وتبقى الاشتراكات الأقل تكلفة للاستخدام المتكرر.

مطور

$99

500 رصيد

صالح لمدة 12 شهرًا

مناسب للتقييم والتكامل المبكر

مصادقة عبر Bearer Token
نتيجة التزوير ودرجة الثقة والخريطة الحرارية وإحداثيات المنطقة
مناسب لسير عمل مراجعة المستندات والصور المتلاعب بها
إمكانية الوصول إلى endpoint و token من لوحة التحكم بعد الشراء

الأكثر شيوعًا

نمو

$359

2,000 رصيد

صالح لمدة 12 شهرًا

مناسب للتجارب الإنتاجية والاستخدام المستقر

مصادقة عبر Bearer Token
نتيجة التزوير ودرجة الثقة والخريطة الحرارية وإحداثيات المنطقة
مناسب لسير عمل مراجعة المستندات والصور المتلاعب بها
إمكانية الوصول إلى endpoint و token من لوحة التحكم بعد الشراء

توسّع

$899

5,000 رصيد

صالح لمدة 12 شهرًا

مناسب لسير العمل الدفعي والفرق متعددة المشاريع

مصادقة عبر Bearer Token
نتيجة التزوير ودرجة الثقة والخريطة الحرارية وإحداثيات المنطقة
مناسب لسير عمل مراجعة المستندات والصور المتلاعب بها
إمكانية الوصول إلى endpoint و token من لوحة التحكم بعد الشراء

أفضل قيمة

أعمال

$2,499

15,000 رصيد

صالح لمدة 12 شهرًا

مناسب لأحمال الإنتاج طويلة الأجل

مصادقة عبر Bearer Token
نتيجة التزوير ودرجة الثقة والخريطة الحرارية وإحداثيات المنطقة
مناسب لسير عمل مراجعة المستندات والصور المتلاعب بها
إمكانية الوصول إلى endpoint و token من لوحة التحكم بعد الشراء

لماذا يثق المطورون بـ API الخاص بنا

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

موثوقية جاهزة للإنتاج

توفر عالي وأداء مستقر محسّن لحركة المرور الواقعية.

محسّن لكشف التزوير

نماذج تركز على المستندات والشهادات والفواتير مع كشف التلاعب للحصول على نتائج أكثر اتساقاً.

تسعير متوقع، API فقط

خطط API مخصصة مع تكاليف واضحة لكل رصيد للتكاملات طويلة الأجل.

الدعم عندما تحتاجه

دعم عبر البريد الإلكتروني لمساعدتك في تشخيص المشكلات وتحسين التكامل الخاص بك بمرور الوقت.

اختر خطة API عرض سياسة الاسترداد

1 رصيد API = 1 طلب API. سعر API أقل من باقات الرصيد لمرة واحدة، بينما تبقى الاشتراكات الخيار الأقل تكلفة للاستخدام المستمر.

واجهة API لاكتشاف تزوير الصوروصول المطورين

أمثلة الطلب والاستجابة

مثال طلب HTTP

أمثلة الاستجابة

استجابة ناجحة

استجابة خطأ تجاري

مقدمة API

اختر أرصدة API

احصل على وصول API

استخدام أمثلة الكود

الانطلاق للإنتاج

المصادقة

نقطة نهاية API

الرؤوس

أمثلة الكود

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

معلمات الاستجابة

رموز الخطأ

خطط تسعير API

مطور

نمو

توسّع

أعمال

لماذا يثق المطورون بـ API الخاص بنا

موثوقية جاهزة للإنتاج

محسّن لكشف التزوير

تسعير متوقع، API فقط

الدعم عندما تحتاجه

واجهة API لاكتشاف تزوير الصور
وصول المطورين