Zum Inhalt springen

API-Dokumentation

SecuFiler API

Versenden Sie Dateien bis 5 TB aus einem Backend-System an einen oder mehrere Empfänger, ohne Eingriff eines Benutzers. Große Dateien werden in Teilen hochgeladen.

Version
1.0.3

Basis-URL

  • Produktionhttps://public-api.secumail.nl
  • Testhttps://test-public-api.secumail.nl

Authentifizierung

  • API-Schlüssel im Header x-api-key

Einen API-Schlüssel oder Zugangsdaten fordern Sie über unseren Kontakt.

Endpunkte

POST/secufiler

Create a transfer and initiate the multipart upload

Request-Body application/json

FeldTypeBeschreibung
sender *string (email)

Sender email address.

recipients *string (email)[]

One or more recipient email addresses.

filename *string
filesize *integer (int64)

Total size of the file in bytes. Used to compute partSize / partCount. Maximum 5 TiB (5497558138880 bytes).

subjectstring

Subject shown in the notification email.

messagestring

Message body shown in the notification email.

nta7516boolean

Apply NTA 7516 (Dutch secure healthcare email) handling. Honoured only when the sender's domain is a SecuMailer customer certified for NTA 7516; forced to false otherwise.

Beispiel

{
  "sender": "system@customer.example",
  "recipients": [
    "bob@partner.example"
  ],
  "filename": "archive.zip",
  "filesize": 10737418240
}

Antworten

  • 201

    Transfer created and multipart upload initiated.

  • 400

    Invalid or missing request parameters — e.g. missing sender/recipients/ filename/filesize, malformed email, unknown nonce/uploadId, or SecuFiler not activated for the customer.

  • 401

    Missing or invalid API key.

  • 403

    The sender's domain is not an eligible SecuMailer customer, or SecuFiler is not activated for it.

  • 413

    Requested filesize exceeds the 5 TiB maximum.

  • 500

    Server-side failure.

POST/secufiler/part

Get a presigned URL for one upload part

Upload the part with a single HTTP PUT of that slice of the file to the returned url, then read the ETag response header — you will need the { partNumber, etag } pairs to complete the upload.

Request-Body application/json

FeldTypeBeschreibung
nonce *string (uuid)

Transfer id from the create response.

uploadId *string
partNumber *integer

Part number (1..partCount).

Beispiel

{
  "nonce": "8f14e45f-ceea-467d-9f0a-1c2d3e4f5a6b",
  "uploadId": "2~Zt1p0Yx9c0bWq3n8sample-upload-id",
  "partNumber": 1
}

Antworten

  • 200

    Presigned URL for the requested part.

  • 400

    Invalid or missing request parameters — e.g. missing sender/recipients/ filename/filesize, malformed email, unknown nonce/uploadId, or SecuFiler not activated for the customer.

  • 401

    Missing or invalid API key.

  • 500

    Server-side failure.

Felder mit * sind Pflichtfelder. Die technischen Beschreibungen stammen aus der OpenAPI-Spezifikation und sind auf Englisch.

Anbindung besprechen?

Möchten Sie wissen, wie SecuMailer an Ihre Anwendung anschließt?

Vereinbaren Sie eine kostenlose Demo. Wir besprechen Ihre Situation und den besten Weg der Anbindung.

Kostenlose Demo vereinbaren