Endpoints / getAttachment

getAttachment

Datei aus dem Patientenordner laden

Lädt eine einzelne Datei aus dem Patientenordner als Base64. Den md5 liefern getDocuments, uploadAttachment oder das Feld attachments aus getPatientHistory.

HTTP Request

POST https://dev.vitabyte.ch/v1/dc/getAttachment
Auth basicAuth apiKey

Request Parameters

Zugriffsprüfung: Die Datei muss unterhalb des Ordners des angefragten Patienten liegen — über einen fremden md5 lässt sich keine Datei eines anderen Patienten ziehen (Access denied).

Parameter Pflicht Typ Beispiel / Default
patid required integer
789
md5

Datei-Identifier aus getDocuments, uploadAttachment oder getPatientHistory.

required string
a3f5effbaf4b369f085809cac9c42845

Response Parameters

Der Inhalt steht in result.b64. Fehler (Attachment not found, PATID missing, Access denied) kommen als {status:false, msg} mit HTTP 200 — kein 403/404.

Field Typ Beschreibung
date string Dokumentendatum
filename string Dateiname
filesize integer Grösse in Bytes
filetype string MIME-Type, z. B. application/pdf
b64 string Dateiinhalt Base64-kodiert
comment string Kommentar aus dem Dokumenten-Center

Demo

Referenz und Beispiele stammen aus der internen API-Collection — die OpenAPI-Spec deckt diesen Endpoint noch nicht ab.

POST https://dev.vitabyte.ch/v1/dc/getAttachment
Payload
{
    "patid": 789,
    "md5": "a3f5effbaf4b369f085809cac9c42845"
}
Response
{
    "status": true,
    "msg": "Success",
    "result": {
        "date": "2026-07-28",
        "filename": "befund.pdf",
        "filesize": 12345,
        "filetype": "application/pdf",
        "b64": "JVBERi0xLjQKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2Jq...",
        "comment": "Laborbefund"
    }
}