API-Dokumentation, Beliebige Dateien mit Hash, echtem MIME, vorläufigem Virenschutzsignal, Metadaten, Mediainformationen, Erkennungsregeln und OCR-Vorschau prüfen.

API : Beliebige Dateien mit Hash, echtem MIME, vorläufigem Virenschutzsignal, Metadaten, Mediainformationen, Erkennungsregeln und OCR-Vorschau prüfen.

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 zu starten

API-Dokumentation, FileInspection

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 zur Bestätigung des Prozessabschlusses. Laden Sie die erzeugten Dateien mit den authentifizierten URLs in 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": "FileInspection",
        "slug": "inspect-file-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": ""
}

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

Kontakt Diese API ist auch im asynchronen Modus verfügbar: Entwickler-API : FileInspection