هذا 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، actionResultsDownloadURLs يحتوي على عناوين URL موثّقة لتنزيل كل ملف نتيجة تم إنشاؤه.



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

أرسل من مقطعي فيديو إلى 15 مقطعاً في file0 حتى file14، أو أرسل عناوين URL عامة مفصولة بالرمز | في fileUrl. يمكن الجمع بين الرفع وعناوين URL. يقتصر كل إدخال على 100 ميغابايت و10 دقائق؛ ويقتصر مجموع الإدخالات على 1 غيغابايت و30 دقيقة.

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

رفع الملفات

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'file0=@/path/to/first.mp4' \ --form 'file1=@/path/to/second.mov' \ --form 'parameters=[]' \ --form 'async=true'

عناوين URL عامة

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'fileUrl=https://example.com/first.mp4|https://example.com/second.webm' \ --form 'parameters=[]' \ --form 'async=true'

احتفظ بمعرّف الإجراء المُعاد واستعلم عن /api/actions/get-action-infos/{id} باستخدام JWT نفسه. عند الاكتمال، يحتوي actionResults على ملف واحد قابل للتنزيل ومحمٍ بالمصادقة اسمه video-concat.mp4.

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

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

تُرفض التعددية والملكية وMIME/المحتوى والحجم والمدة قبل المعالجة مع خطأ ثابت من نوع VIDEO_CONCAT_*.

اتصل بنا


يرسل API استجابة JSON لتأكيد بدء العملية. لاحظ حقل « trackingUrl » الذي يتيح لك متابعة العملية التي بدأتها. وتتضمن الاستجابة أيضاً معرّف العملية؛ المعرّف في هذا المثال هو 643: { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/643" }


• لمتابعة التقدم، أجرِ طلب GET بسيطاً (يمكنك إجراء هذا الاستدعاء كل 10 ثوانٍ):
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

إذا لم تكتمل العملية بعد، فستتلقى هذا النوع من الاستجابة مع "accomplished": false { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": null, "endTime": null, "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

إذا اكتملت العملية، فستتلقى هذا النوع من الاستجابة مع "accomplished": true. يحتوي الحقل actionResultsDownloadURLs على عناوين URL موثقة لتنزيل النتائج المُنشأة: { "actionResultsDownloadURLs": [ "https://mxprocess.com/api/actions/download-result/643/35084b44a841ec597be3048df44145e8.txt.log/YOUR_TOKEN" ], "id": 643, "actionParameters": { "commandParameters": "" }, "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": "2024-01-28T11:24:49+01:00", "endTime": "2024-01-28T11:25:09+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": true, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [ [ "35084b44a841ec597be3048df44145e8.txt.log" ] ], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

استخدم كل عنوان URL وارد في actionResultsDownloadURLs مباشرة لتنزيل النتيجة المقابلة.

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

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