Synchronen Datei-Scan übermitteln
Laden Sie eine Datei für einen Malware-Scan hoch und warten Sie innerhalb des synchronen Polling-Fensters von 90 Sekunden 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 Scan-ID zurückgegeben. Verwenden Sie die Scan-ID, um über die GET-Endpunkte weiter abzufragen.
Wenn Webhooks im Blazelock-Dashboard aktiviert sind, werden Webhook-Ereignisse gesendet, während der Scan fortschreitet.
Authorization
bearerAuth Im Blazelock-Dashboard generierter API-Key.
Senden Sie ihn im HTTP-Header Authorization als Bearer <api-key>.
In: header
Header-Parameter
Zweistelliger ISO-Sprachcode für lokalisierte menschenlesbare Antworttexte. Unterstützte Werte:
en= Englischde= Deutsch
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.
TypeScript-Definitionen
Verwenden Sie den Typ "request body" in TypeScript.
Request-Payload zum Übermitteln eines synchronen Datei-Scans.
Response-Body
application/json
application/json
application/json
curl -X POST 'https://example.com/file-scans/sync' \ -F 'attributes={"file_name":"invoice.pdf"};type=application/json' \ -F 'file=@invoice.pdf'{
"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",
"findings": []
},
"completed_at": "2026-03-09T12:35:11.000Z",
"scan_duration_ms": 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."
}