Diese API ist einfach zu verwenden. Befolgen Sie einfach diese Schritte

• Kostenloses Konto erstellen
• Klicken Sie auf den Link in der E-Mail, um Ihre Adresse zu bestätigen.
• Token mit Zugangsdaten erzeugen

Sie können für diesen CURL-Aufruf jede Sprache verwenden. (Python, PHP, Java, JavaScript...) Brauchen Sie Hilfe?

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

Wenn Ihre Zugangsdaten korrekt sind, liefert unser Server als Antwort ein Token: {"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}
YOUR_TOKEN ist eine Stunde gültig; die Gültigkeit kann mit YOUR_REFRESH_TOKEN verlängert werden.


• Verwenden Sie das Token, um den Prozess asynchron zu starten
Ergebnisse werden heruntergeladen: Wenn es in einer API-Antwort vorhanden ist, actionResultsDownloadURLs enthält es die authentifizierten URLs zum Herunterladen jeder erzeugten Ergebnisdatei.



Asynchrone API: Videos zusammenfügen

Senden Sie 2 bis 15 Videos als file0 bis file14 oder öffentliche URLs, getrennt durch |, in fileUrl. Uploads und URLs können kombiniert werden. Jede Eingabe ist auf 100 MB und 10 Minuten begrenzt; alle Eingaben zusammen auf 1 GB und 30 Minuten.

Endpunkt: POST https://mxprocess.com/api/files/start-process
Authentifizierung: Bearer JWT
Kosten: 15 Tokens, nur nach erfolgreichem Abschluss berechnet.

Dateien hochladen

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'

Öffentliche URLs

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'

Speichern Sie die zurückgegebene Aktions-ID und fragen Sie /api/actions/get-action-infos/{id} mit demselben JWT ab. Nach Abschluss enthält actionResults eine authentifizierte Datei namens video-concat.mp4 zum Herunterladen.

Erstantwort

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

Kardinalität, Eigentümerschaft, MIME-Typ und Inhalt, Größe sowie Dauer werden vor der Verarbeitung geprüft; bei einem Fehler wird ein stabiler VIDEO_CONCAT_*-Fehler zurückgegeben.

Kontakt


Die API sendet eine JSON-Antwort, um den Start des Prozesses zu bestätigen. Beachten Sie das Feld « trackingUrl », mit dem Sie den gestarteten Prozess verfolgen können. Die Antwort enthält auch die Prozess-ID; in diesem Beispiel ist sie 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" }


• Um den Fortschritt zu verfolgen, senden Sie eine einfache GET-Anfrage (Sie können diesen HTTP-Aufruf alle 10 Sekunden ausführen):
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

Wenn der Prozess noch nicht abgeschlossen ist, erhalten Sie diese Antwort mit "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": "" }

Wenn der Prozess abgeschlossen ist, erhalten Sie diese Antwort mit "accomplished": true. Das Feld actionResultsDownloadURLs enthält authentifizierte URLs zum Herunterladen der erzeugten Ergebnisse: { "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": "" }

Verwenden Sie jede unter actionResultsDownloadURLs angegebene URL direkt zum Herunterladen des zugehörigen Ergebnisses.

Ist diese Dokumentation unklar? (Python, PHP, Java, JavaScript...) Brauchen Sie Hilfe?

Kontakt Diese API ist auch im synchronen Modus verfügbar: Entwickler-API : VideoConcat