Blazelock
Datei-Scans

Synchronen Datei-Scan übermitteln

Laden Sie eine Datei für einen Malware-Scan hoch und warten Sie innerhalb des synchronen Polling-Fensters auf ein finales Ergebnis. Abhängig vom Ergebnis gibt die Antwort einen abgeschlossenen oder fehlgeschlagenen Status zurück. Wenn das Polling-Fenster endet, bevor ein finales Ergebnis verfügbar ist, wird ein Timeout-Fehler zusammen mit der erstellten Datei-Scan-ID zurückgegeben.

POST/file-scans/sync

Authorization

bearerAuth
AuthorizationBearer <token>

Im Blazelock-Dashboard generierter API-Key. Senden Sie ihn als Authorization: Bearer <api-key>.

In: header

Header Parameters

Content-Language?string

Zweistelliger ISO-Sprachcode für lokalisierte menschenlesbare Antworttexte. Unterstützte Werte:

  • en = Englisch
  • de = Deutsch
Value in"en" | "de"

Request Body

multipart/form-data

Multipart-Form-Payload für einen synchronen Datei-Scan. Sie enthält einen binären file-Teil und einen als JSON codierten attributes-Teil mit dem Content-Type application/json.

Response Body

application/json

application/json

application/json

{
  "id": "019583d8-b2e4-7b8d-9d1f-6f4cb3d0b6f1",
  "external_reference_id": "invoice-4711",
  "status": "completed",
  "execution_mode": "sync",
  "file_name": "invoice.pdf",
  "file_size": 245761,
  "file_type": "application/pdf",
  "file_hash": {
    "md5": "d41d8cd98f00b204e9800998ecf8427e",
    "sha1": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
    "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  },
  "result": {
    "safe": true,
    "detailed": "clean"
  },
  "completed_at": "2026-03-09T12:35:11.000Z",
  "scan_duration": 250,
  "submitted_at": "2026-03-09T12:34:56.000Z"
}

{
  "code": "sync_scan_timeout",
  "message": "Der Datei-Scan dauert länger als erwartet. Sie können den Status dieses Scans weiterhin mit seiner ID über den Status-Endpunkt abfragen.",
  "file_scan_id": "019583d8-b2e4-7b8d-9d1f-6f4cb3d0b6f1"
}
{
  "code": "duplicate_external_reference_id",
  "message": "Die externe Referenz-ID existiert bereits für diese Anbindung."
}