توثيق API, فحص أي ملف مع التجزئة وMIME الحقيقي وإشارة أولية لمكافحة الفيروسات والبيانات الوصفية ومعلومات الوسائط وقواعد الكشف ومعاينة OCR.

API : فحص أي ملف مع التجزئة وMIME الحقيقي وإشارة أولية لمكافحة الفيروسات والبيانات الوصفية ومعلومات الوسائط وقواعد الكشف ومعاينة OCR.

هذا API سهل الاستخدام. ما عليك سوى اتباع هذه الخطوات

إنشاء حساب مجاني
انقر على الرابط الذي يصلك عبر البريد الإلكتروني لتأكيد عنوانك.
إنشاء رمز باستخدام بيانات الاعتماد

يمكنك استخدام أي لغة لإجراء استدعاء CURL هذا. (Python, PHP, Java, JavaScript...) هل تحتاج إلى مساعدة؟

curl --location --request POST 'https://mxprocess.com/api/login_check' \
                                        --header 'Content-Type: application/json' \
                                        --data-raw '{"username":"YOUR_LOGIN","password":"YOUR_PASSWORD"}'

إذا كانت بيانات اعتمادك صحيحة، فسيقدم خادمنا رمزاً في الاستجابة:

{"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}

يبقى YOUR_TOKEN صالحاً لمدة ساعة؛ ويمكن تمديد مدته باستخدام YOUR_REFRESH_TOKEN.

استخدم الرمز لبدء العملية

توثيق API, FileInspection

جارٍ تنزيل النتائج: عند وروده في استجابة API، actionResultsDownloadURLs يحتوي على عناوين URL موثّقة لتنزيل كل ملف نتيجة تم إنشاؤه.

واجهة API غير متزامنة: فحص شامل للملفات

أرسل ملفاً غير فارغ حجمه حتى 50 ميبيبايت. يُقرأ الأصل ولا يُنقل أو يُعدّل أو يُحذف أبداً. التقرير تشخيصي: نتيجة محرك مكافحة الفيروسات إشارة فرز أولية، ومجموعة قواعد الكشف المرفقة ليست سوى نقطة بداية محدودة.

نقطة النهاية: POST https://mxprocess.com/api/files/start-process
المصادقة: Bearer JWT
التكلفة: 12 رموز، تُحصّل بعد النجاح.

بدء الفحص

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'actionName=FileInspection' \
--form 'file=@/path/to/file.bin' \
--form 'parameters=[]' \
--form 'async=true'

احفظ القيمة المعادة id واستعلم عن /api/actions/get-action-infos/{id} باستخدام JWT نفسه. عند الاكتمال، actionResults يحتوي على ملف واحد موثّق قابل للتنزيل *.inspection.json .

الاستجابة الأولية

{"id":123,"action":{"actionName":"FileInspection","slug":"inspect-file-online"},"accomplished":false,"actionResults":[],"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

مثال على استجابة ناجحة

{
  "fileName": "photo.jpg",
  "sizeBytes": 24576,
  "sha256": "...",
  "mimeDetected": "image/jpeg",
  "mimeDeclared": null,
  "antivirusSignal": {"status": "clean", "detail": "preliminary triage signal"},
  "exif": {"ImageWidth": 800, "ImageHeight": 600},
  "mediaProbe": null,
  "detectionRules": {"status": "clean", "matches": [], "ruleset": "minimal detection rule set"},
  "ocrText": "Complete text detected in the image...",
  "generatedAt": "2026-09-12T12:00:00+00:00"
}

إذا لم تتوفر أداة محلية اختيارية، يُعاد قسمها كـ not_run أو null. تُرفض الكمية غير الصالحة أو الملف الذي يتعذر الوصول إليه أو الملف الأكبر من 50 ميبيبايت قبل التحليل.

اتصل بنا

يرسل API استجابة JSON لتأكيد انتهاء العملية. نزّل الملفات المُنشأة باستخدام عناوين URL الموثقة في actionResultsDownloadURLs.


{
    "actionResultsDownloadURLs": [
        "https://mxprocess.com/api/actions/download-result/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3/YOUR_TOKEN"
    ],
    "id": 1016,
    "actionParameters": [],
    "dateOfDemand": "2024-02-07T20:51:42+00:00",
    "startTime": "2024-02-07T20:51:46+01:00",
    "endTime": "2024-02-07T20:51:46+01:00",
    "hostedFileIds": [
        {
            "fileId": 1025,
            "parameters": ""
        }
    ],
    "action": {
        "actionName": "FileInspection",
        "slug": "inspect-file-online",
        "jsonRequestSample": null,
        "jsonResponseSample": null,
        "specificDeveloperRequestDocumentation": null,
        "specificDeveloperResponseDocumentation": null,
        "longDescription": null
    },
    "user": [],
    "accomplished": true,
    "userIsNotifiedByEmail": "off",
    "userIsNotifiedByPostQuery": "off",
    "actionResults": [
        [
            "a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3",
            "https://mxprocessfiles.s3.eu-west-1.amazonaws.com/AudioToGPT/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3"
        ]
    ],
    "priceInTokensAtTimeOfUse": 15,
    "retryCount": 0,
    "executionPlannedAt": null,
    "trackingUrl": ""
}

هل هذا التوثيق غير واضح؟ (Python, PHP, Java, JavaScript...) هل تحتاج إلى مساعدة؟

اتصل بنا يتوفر هذا API أيضاً في الوضع غير المتزامن: API للمطورين : FileInspection