(Binary file content — save the response to a file)
{ "error": "Document not found"}
Lade ein Laborberichtsdokument über seine Datei-ID herunter. Gibt die rohen Datei-Bytes mit dem passenden Content-Type-Header zurück. Die Dokument-IDs findest du im documents-Array der Antwort von Laborergebnisse abrufen.Erfordert den Scope results_view.
Der Zugriff wird anhand des Profils geprüft, zu dem das Dokument gehört. Ein Dokument, das du mit Dokument hochladen hochgeladen hast, wird anhand der Profilgruppe geprüft, unter der es hochgeladen wurde.
Anfrage
Pfadparameter
string
erforderlich
Datei-ID (UUID) aus dem documents-Array in der Antwort der Terminergebnisse.
Antwort
Bei Erfolg gibt die API 200 OK mit den Datei-Bytes und vier Headern zurück. Jeder Header enthält ein Feld aus dem documents-Array:
Original-File-Name ist prozentkodiertes UTF-8, weil ein Header nicht jedes Zeichen übertragen kann, das ein hochgeladener Name enthalten kann. Dekodiere ihn mit decodeURIComponent oder einer vergleichbaren Funktion.ETag und If-None-Match sind die Standard-HTTP-Caching-Header (RFC 9110). Sende den gespeicherten etag in If-None-Match, um eine unveränderte Datei zu überspringen. Die API antwortet dann mit 304 Not Modified ohne Body.
Fehlerantworten
Status
Beschreibung
304
Nicht geändert – der If-None-Match-ETag passt noch zur Datei. Kein Body.
400
Ungültiges ID-Format – der angegebene Wert ist keine gültige UUID.
403
Zugriff verweigert – dein API-Schlüssel hat keinen Zugriff auf diesen Vorgang oder das Dokument liegt außerhalb deines Zugriffskontexts.