Datei herunterladen

Lädt die entschlüsselte Binärdatei herunter. Der Server gibt die Datei direkt als Bytestream zurück.

Request

GET /api/oauth/v2/resource/files/{uuid}/download

Header

Header	Wert
Authorization	Bearer {access_token}

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string	Ja	Eindeutige ID der Datei

Response

Erfolg (200 OK)

Der Response enthält die entschlüsselte Datei als Binärdaten. Die Response-Header steuern den Download:

Header	Beispielwert	Beschreibung
Content-Type	application/pdf	MIME-Typ der Datei
Content-Disposition	attachment; filename="befund-mrt.pdf"	Löst einen Download aus; enthält den originalen Dateinamen

Hinweis: Dieser Endpoint gibt keinen JSON-Body zurück, sondern die rohen Bytes der Datei. Verarbeiten Sie die Antwort direkt als Dateiinhalt.

Beispiel (cURL)

curl -X GET "https://app.offisy.at/api/oauth/v2/resource/files/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download" \
  -H "Authorization: Bearer {access_token}" \
  --output befund-mrt.pdf

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/files/b2c3d4e5-f6a7-8901-bcde-f01234567890/download" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope medicals nicht vorhanden
403	access_denied	Keine Leseberechtigung für diese Datei
404	not_found	Datei nicht gefunden oder gehört nicht zu diesem Unternehmen