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: universelle Dateiprüfung

Übermitteln Sie eine nicht leere Datei bis 50 MiB. Das Original wird gelesen, aber niemals verschoben, geändert oder gelöscht. Der Bericht ist diagnostisch: Das Ergebnis des Virenschutzes ist ein vorläufiges Triage-Signal und der enthaltene Regelsatz nur ein minimaler Ausgangspunkt.

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

Prüfung starten

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'

Speichern Sie die zurückgegebene id und fragen Sie ab /api/actions/get-action-infos/{id} mit demselben JWT. Nach Abschluss actionResults enthält eine authentifizierte herunterladbare *.inspection.json Datei.

Erste Antwort

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

Beispiel für eine erfolgreiche Antwort

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

Wenn ein optionales lokales Werkzeug nicht verfügbar ist, wird sein Abschnitt als not_run oder null. Eine ungültige Anzahl, eine nicht zugängliche Datei oder eine Datei über 50 MiB wird vor der Analyse 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": "FileInspection", "slug": "inspect-file-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": "FileInspection", "slug": "inspect-file-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": "FileInspection", "slug": "inspect-file-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 : FileInspection