Page History
...
| Service udstil type | REST med JTP-H bearer token. | |
| Krævede adgange | JTP-H token identificerer borgeren, der har adgang til egne dokumenter. | |
| Whitelisting | Nej | |
| Krævet sikkerhedsniveau | Data udstilles kun til borgerlogin, og kun borgerens egne dokumenter. | |
| Forudsætninger for anvendelse | Ligesom ved brug af DDS er det anvenders ansvar kun at hente dokumenter via ITI-68, som kalder umiddelbart forinden har fået udleveret link til via ITI-67. Dette sikrer de udleverede dokumenters aktualitet. Da der kun er tale om borgertilgang til egne dokumenter er spærring ikke et problem, men dokumenter kan deprecates og erstattes af nye versioner på DDS. | |
| Logning | Der logges almindelig auditlog med kald-log jf. husreglerne. | <evt. yderligere krav eller forhold> |
<Eventuel nærmere introduktion>
<Eventuel yderligere beskrivelse af området / domænet som servicen/komponenten servicerer>.
<Samt yderligere information som er vigtigt for anvendelsen eller forståelsen>
Definitioner og referencer
| Reference | Beskrivelse |
|---|---|
| JTP-H | JWT Token Profile for Healthcare |
| FHIR | Fast Healthcare Interoperability Resources. En standard udviklet af HL7 (Health Level 7) til elektronisk udveksling af sundhedsoplysninger. |
| DDS | Dokument Delingsservice |
Adgang, brug og snitflader
...
Adgang til servicen sker ved at medsende en Authorization-header med bearer token i form af JTP-H. Et gyldigt JTP-H token til test kan erhverves vha. OATH 2.0 med følgender følgende properties (fra GMv2):
| url | https://test.cloud.idm.trifork.com/auth/realms/gravid/protocol/openid-connect/auth |
| access token url | https://test.cloud.idm.trifork.com/auth/realms/gravid/protocol/openid-connect/token |
| client id | gravidapp |
| redirect url | gravidapp |
| scope | openid profile |
...
| Endpoint | <serverurl>/mhd/api/2025/05/06/DocumentReference?patient.identifier=2311890002 |
| Beskrivelse af services | Returnerer dokument referencer for borgeren. Bemærk, der returneres kun de dokumenttyper som er MHD'en er konfigureret til at returnererreturnere. |
| Resultat | Bundle med DocumenReference resourcer |
...
| Endpoint | <serverurl>/mhd/api/2025/05/06/Binary/1.2.208.193%5E12345f0f-648f-4760-841a-05e96e3c3990?repositoryID=1.2.208.176.43210.8.10.15&homeCommunityID=1.2.208.176.43210.8.10 |
| Beskrivelse af services | Returnerer binaries indeholdende dokumenter fra DDS. Bemærk, ovenstående url findes i svaret fra hent dokumentreferencer og det er derfor ikke meningen at man selv skal konstruere den. |
| Resultat | Binary med dokument fra DDS |
...
Response er en FHIR Binary ressource hvor dokumentet er base 64 encoded i "data" elementet.
...
<Beskrivelse af fejlbeskeder, og i hvilke situationer man kan forvente at se disse i.
Noter omkring ting som går på tværs af services. Det kan være fejl som optræder generelt og som man skal være opmærksom på.>
Eksempler på request/response
...
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |
| 10/4 2025 | Anders Ringsmose/Trifork | Forslag til API |
| 7/8 2025 | Thomas Glæsner/Trifork | Udfyldelse af dokumentation |