Page History
...
| Service udstil type | REST service med JWT bearer token autentifikation. |
| Krævede adgange | JWT 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. |
Adgang, brug og snitflader
Adgang
<Beskrivelse af hvordan service/komponent bruges, snitflade(r), endpoints, og andet relevant>
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 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 |
Endpoints:
Hent dokumentreferencer (ITI-67):
| 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 returnerer. |
| Resultat | Bundle med DocumenReference resourcer |
Hent binaries (ITI-67):
| 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 |
<Angiv udstillede endpoint(s), og hvad de hedder.>
<Angiv henvisning til WSDL(er). For ekstern anvendbare services typisk på https://wsdl.nspop.dk/>
<Beskrivelser af service(s) / actions på endpoint(s). I lægmands termer beskrive hvad man kan forvente af de enkelte services.>
Snitfladebeskrivelse og brug
Anvender skal kalde ITI-67 for at få udleveret en aktuel liste af links til dokumenter. Disse links kan umiddelbart derefter bruges i ITI-68 kald for at hente indholdet af dokumenterne. Links til dokumenter bør ikke lagres til senere anvendelse, da status mm. kan skifte på dokumentdelingsservicen, fx deprecating af dokument ved erstatning med en ny version.
MHDService-instansen henter dokumenter for den angivne patient i det dokument repository den enkelte instans er konfigureret op til. Man kan fx kun hente dokumenter fra graviditetsmappens repository med graviditetsmappe-instansen af MHDService.
ITI-67
ITI-67 (registry opslag) udstiller søgning efter dokumenter i graviditetsmappen for en specifik patient baseret på søgeparameteren "patient.identifier". MHD standarden tilbyder en række yderligere søgeparametre, men disse er ikke supporteret endnu.
ITI-67 Request
Request til ITI-67 er et GET eller POST kald til "<MHDService instance base URL>/DocumentReference" med parameteren "patient.identifier" angivet som url-parameter eller i body'en. Parameteren angiver patientens CPR nummer.
...
| ITI-67 parametre | ||
|---|---|---|
| Parameter | Beskrivelse | Påkrævet |
| patient.identifier | Patientens CPR nummer | Ja |
ITI-67 Response
Response er et FHIR searchset Bundle med MedComDocumentReference ressourcer for de fundne dokumenter.
ITI-68
ITI-68 (repository opslag) udstiller opslag efter dokumenter i graviditetsmappen. I ITI-67 kaldet er givet et antal MedComDocumentReferences der har en URL til hvert enkelt dokument. På denne URL findes ITI-68 opslaget efter dokumentet.
URL'en for hvert dokument vil være på formen "<MHDService instance base URL>/Binary/<documentId>", og vil returnere objektet i form af en Binary FHIR ressource, med CDA'en som "data".
ITI-68 Request
Request til ITI-68 er et GET kald til "<MHDService instance base URL>/Binary/<documentId>", hvor værdien af "documentId" angiver dokumentets "DocumentUniqueId".
...
| ITI-67 parametre | ||
|---|---|---|
| Parameter | Beskrivelse | Påkrævet |
| documentId | Dokumentets DocumentUniqueId | Ja |
ITI-68 Response
Response er en FHIR Binary ressource hvor dokumentet er base 64 encoded i "data" elementet.
Fejlbeskeder
<Beskrivelse af fejlbeskeder, og i hvilke situationer man kan forvente at se disse i.
...