Indholdsfortegnelse
Introduktion
Formål
Denne guide har som formål at give et overblik over Graviditetsmappens app facade (GM Facade). Formålet med dokumentet er at give anvendere et overblik over løsningen, samt en oversigt over, hvilke User Stories der er understøttet af GMAF og hvordan disse er implementeret (flows).
Beskrivelse
GM Facade er en REST udstilling af Graviditetsmappens journal data som en FHIR model sikret med JTP-H.
Links til mere information
Dokumentation for anvendt FHIR model findes her: https://build.fhir.org/ig/trifork/gm-fhir-ig/branches/main/index.html
Dokumentation for krav til JTP-H findes her: NSP Access Handler - Design og arkitekturbeskrivelse
Grafisk fremstilling og sammenhængen
<Tegning(er) der letter forståelsen og beskrivelser af relevante sammenhængen>
Relevante use-cases
Pt. er det kun borgeren selv der kan hente data via. denne GM Facade.
Læsevejledning og forudsætninger
Dette dokument er henvendt til udviklere og arkitekter, der skal anvende GM Facade.
Sikkerhed
| Service udstil type | REST med JTPH bearer token. |
| Krævet sikkerhedsniveau | Pt. kun borgeradgang |
| Logning | Standard adgangslog via NSP Access Handler |
Definitioner og referencer
| Reference | Beskrivelse |
|---|---|
| JTP-H | JWT Token Profile for Healthcare |
| GM Facade | Graviditetsmappens app facade |
| FHIR | FHIR står for Fast Healthcare Interoperability Resources. Det er en standard udviklet af HL7 (Health Level 7) til elektronisk udveksling af sundhedsoplysninger. |
Adgang, brug og snitflader
Adgang
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:
| 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:
| Endpoint | <serverurl>/gmaf/api/2025/06/25/journal |
| Beskrivelse af services | Returnerer borgeren (som angivet i JTP-H) journaldata vedrørende Graviditetsmappen |
| Resultat | Dokumenttyperne Svangerskabsjournal, vandrejournal og Målinger |
Snitfladebeskrivelse og brug
Hent journal for borger
Hent Journal
Henter borgers journal i Graviditetsmappen
| GET <serverurl>/gmaf/api/2025/06/25/journal | |
|---|---|
| Header | Value |
| Authorization | Bearer: eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIySWh5aEM4Y1o3WEtmVm1BVG53Wnpxam00THFwMWFnN000d3UyTjNLVGtzIn0.eyJleHAi.... |
Endpointet returner et JSON svarende til IG'en https://build.fhir.org/ig/trifork/gm-fhir-ig/branches/main/index.html
<snitflade 2, osv., med request/response>
Generelle koder, værdier, etc.
<Angiv eventuelle generelle koder, værdier, etc>
Fejlbeskeder
<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
Eksempler på request og response til de operationer der udstilles. De enkelte elementer er beskrevet under snitfladebeskrivelse. Klient proxier kan genereres udfra WSDL'en.
<eksempel 1 på ..>
<mere eksempel>
Test
<beskriv Test muligheder, test-systemer og eventuelle testdata>
Eksempel kode og klient
Eksempel kode
<Eksempel kode. Det er meget lettere at lave sin egen implementering, hvis man kan kigge efter en anden ....>
Eksempel klient
<og hvor det giver mening angiv eventuel eksempel klient, samt hvordan og hvor det eventuelt kan eksekveres>
Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |