Page History
...
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 dokument (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 |
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.
...