Endpoints / uploadAttachment

uploadAttachment

Datei in den Patientenordner hochladen

Legt eine Base64-kodierte Datei im Patientenordner ab und registriert sie im Dokumenten-Center.

HTTP Request

POST https://dev.vitabyte.ch/v1/dc/uploadAttachment

Auth basicAuth apiKey

Request Parameters

Erlaubte Dateitypen: docx, pdf, odt, jpg, jpeg, png, svg, txt — alles andere wird abgewiesen.
Existiert der Zielname bereits, wird eine Version angehängt; der tatsächlich gespeicherte Name steht in result.filename.

Parameter	Pflicht	Typ	Beispiel / Default
`patid`	required	integer	789
`filename` Inklusive Endung; wird serverseitig bereinigt.	required	string	befund.pdf
`b64` Base64-kodierter Dateiinhalt.	required	string
`date` Dokumentendatum; Default ist heute.	optional	string	2026-07-28
`comment` Kommentar im Dokumenten-Center.	optional	string	Laborbefund
`folder` Unterordner im Patientenordner; leer = Wurzel.	optional	string	Berichte

Response Parameters

Alle Fehler kommen als {status:false, msg} mit HTTP 200: PATID missing, Filename missing, File content missing, File type not allowed.

Field	Typ	Beschreibung
`md5`	string	Datei-Identifier — direkt in getAttachment verwendbar
`filename`	string	Tatsächlich gespeicherter Dateiname

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/uploadAttachment

Payload

{
    "patid": 789,
    "filename": "befund.pdf",
    "b64": "JVBERi0xLjQKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2Jq...",
    "date": "2026-07-28",
    "comment": "Laborbefund",
    "folder": "Berichte"
}

Response

{
    "status": true,
    "msg": "Attachment uploaded",
    "result": {
        "md5": "a3f5effbaf4b369f085809cac9c42845",
        "filename": "befund.pdf"
    }
}