Blazelock
Datei-Scans

Asynchronen Datei-Scan übermitteln

Laden Sie eine Datei für einen Malware-Scan hoch. Der Scan wird asynchron im Hintergrund fortgesetzt. Die Antwort gibt den initialen Verarbeitungsstatus zusammen mit der erstellten Scan-ID zurück.

Verwenden Sie die Scan-ID, um das Ergebnis über die GET-Endpunkte abzufragen.

Wenn Webhooks im Blazelock-Dashboard aktiviert sind, werden Webhook-Ereignisse gesendet, während der Scan fortschreitet.

POST
/file-scans

Authorization

bearerAuth
AuthorizationBearer <token>

Im Blazelock-Dashboard generierter API-Key.

Senden Sie ihn im HTTP-Header Authorization als Bearer <api-key>.

In: header

Header-Parameter

Content-Language?string

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

  • en = Englisch
  • de = Deutsch

Request-Body

multipart/form-data

Multipart-Form-Payload für einen asynchronen 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 asynchronen Datei-Scans.

Response-Body

application/json

application/json

curl -X POST 'https://example.com/file-scans' \     -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": "processing",
  "execution_mode": "async",
  "file_name": "invoice.pdf",
  "file_size": 245761,
  "submitted_at": "2026-03-09T12:34:56.000Z"
}
{
  "code": "duplicate_external_reference_id",
  "message": "Die externe Referenz-ID existiert bereits für diese Anbindung."
}