API

كشف ملف

افحص ملفاً مقابل العلامات النشطة في مساحة عمل Business أو Enterprise.

POST/api/v1/detect

يفحص ملفاً ضمن مساحة عمل هذا المفتاح. الجسم بصيغة multipart/form-data.

المصادقة

Authorization: Bearer mf_…

أرسل هذه الترويسة. لا يوجد ملف تعريف ارتباط للجلسة. يُقبل curl وعملاء الخادم الآخرون. يُرفض متصفح على موقع آخر.

المعاملات

الاسمالنوعمطلوبالوصف
filefileنعمالملف المراد فحصه. يُبحث عن التطابق في مساحة عمل هذا المفتاح فقط. الملف المعلَّم في مساحة عمل أخرى لا يُحل. يمكن لمساحة عمل Business أو Enterprise نشطة أن تفحص ملف فيديو أيضاً. تُفحص لقطة شاشة لإطار واحد كصورة.

الطلب

curl -X POST https://markedfile.com/api/v1/detect \
  -H "Authorization: Bearer mf_…" \
  -F "file=@leaked.pdf"

الاستجابة

{
  "id": "northwind",
  "confidence": 0.95,
  "layers": [
    {
      "name": "Metadata",
      "hit": true,
      "detail": "Authenticated metadata matched this workspace",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "notes": [
    "Confidence is 99% for an exact file or when an authenticated mark agrees with another mark. A visual match alone stays lower, and weak bit agreement stays far from a high score."
  ]
}

id هو المعرّف الذي عيّنته أنت حين عُلّمت تلك النسخة، أو null حين لا يكون لهذه المساحة تطابق. confidence هي 99% لملف مطابق تماماً أو حين تتفق علامة موثّقة مع علامة أخرى. يبقى التطابق البصري وحده أدنى. يسرد layers الحوامل، وتكون hit بقيمة true على التي اتفقت. يصف notes ما فعله الفحص. الملف المحذوف لا يُحل.

الأخطاء

حقل error في جسم JSON بالإنجليزية.

الحالةالوصف
400الملف فارغ.
401المفتاح مفقود أو ملغى أو غير معروف. يتضمن جسم JSON الحقل "code": "api-key".
403لم تعد مساحة العمل على خطة Business أو Enterprise نشطة (يتضمن الجسم "code": "enterprise")، أو أرسل المتصفح طلباً cross-site أو same-site.
413يتجاوز الملف حد الرفع في الخطة، أو يحتوي PDF على صفحات أكثر مما تسمح به الخطة.
422تعذّر معالجة الملف.
429أجري هذا المفتاح أكثر من 80 عملية كشف في الدقيقة الحالية.

حد المعدل

80 طلباً في الدقيقة لهذا المفتاح. يُخزَّن العداد في قاعدة بيانات المنتج ويبقى بعد إعادة التشغيل.