Synchronen Datei-Scan übermitteln

Server-URLLädt...

POST

/file-scans/sync

Senden

Authorization

Header

Body

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.

Header-Parameter

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

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