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: Dateimetadaten bereinigen

Senden Sie genau eine Bild-, PDF-, Audio- oder Videodatei bis 50 MiB. Das Original wird nie verändert. Der Dienst entfernt erkannte übliche Metadaten aus einer Kopie und bewahrt, sofern unterstützt, Orientierungs- und Farbprofil-Tags. Eine vollständige Anonymisierung wird nicht garantiert.

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

Bereinigung starten

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'

Speichern Sie die zurückgegebene id und rufen Sie /api/actions/get-action-infos/{id} mit demselben JWT ab. Wenn accomplished auf true, actionResults enthält sowohl die bereinigte Datei (cleaned-<original>) als auch die Datei <original>.metadata-report.json. Laden Sie jedes Ergebnis über seine authentifizierte URL herunter.

Erstantwort

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

Abgeschlossener Bericht

{ "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" }

Wenn die Datei keine beschreibbaren Metadaten besitzt (etwa eine Textdatei), wird die Kopie unverändert zurückgegeben und metadataFoundBefore ist false. Ungültige Anzahl, eine nicht zugängliche Datei oder eine Datei über 50 MiB wird vor der Verarbeitung abgelehnt.

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": "MetadataCleaner", "slug": "clean-file-metadata-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": "MetadataCleaner", "slug": "clean-file-metadata-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": "MetadataCleaner", "slug": "clean-file-metadata-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 : MetadataCleaner