توثيق API, إزالة البيانات الوصفية الحساسة الشائعة التي يكتشفها ExifTool مع الحفاظ على محتوى الملف.

API : إزالة البيانات الوصفية الحساسة الشائعة التي يكتشفها ExifTool مع الحفاظ على محتوى الملف.

هذا 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, MetadataCleaner

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

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

أرسل ملف صورة أو PDF أو صوت أو فيديو واحداً بحجم لا يتجاوز 50 ميبيبايت. لا يُعدّل الأصل أبداً. تزيل الخدمة من نسخة من الملف البيانات الوصفية الشائعة التي يتعرف عليها ExifTool وتحافظ، عند الدعم، على وسوم الاتجاه وملف تعريف الألوان. لا يضمن ذلك إخفاء الهوية بالكامل.

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

بدء التنظيف

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

احفظ id واستعلم من /api/actions/get-action-infos/{id} باستخدام JWT نفسه. عندما تكون accomplished قيمتها true, actionResults تحتوي على الملف المنظف (cleaned-<original>) والملف <original>.metadata-report.json. نزّل كل نتيجة عبر عنوانها الموثق.

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

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

التقرير المكتمل

{
  "fileName": "photo.jpg",
  "sizeBytesBefore": 24576,
  "sizeBytesAfter": 23100,
  "sha256Before": "...",
  "sha256After": "...",
  "metadataFoundBefore": true,
  "metadataKeysBefore": ["Make", "GPSLatitude", "GPSLongitude"],
  "metadataKeysAfter": [],
  "removedFields": ["GPSLatitude", "GPSLongitude", "Make"],
  "preservedFields": [],
  "generatedAt": "2026-09-12T12:00:00+00:00"
}

إذا لم يتضمن الملف بيانات وصفية قابلة للكتابة (مثل النص العادي)، تُعاد النسخة دون تغيير وتكون metadataFoundBefore قيمتها false. يُرفض قبل المعالجة عدد الملفات غير الصحيح أو الملف غير المتاح أو الملف الذي يتجاوز 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": "MetadataCleaner",
        "slug": "clean-file-metadata-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 للمطورين : MetadataCleaner