Johdanto
Tähän soveltamisoppaaseen on koostettu Kanta FHIR- ja REST-rajapintamäärittelyt, jotka koskevat useita eri Kanta-palveluita. Yksittäisten palveluiden palvelukohtaiset FHIR- ja REST-rajapintamäärittelyt, kuvaukset ja ohjeet löytyvät kunkin palvelun omista soveltamisoppaista.
Soveltamisopas koostuu seuraavista osista:
- Johdanto
- Kanta FHIR hyödyntäminen
- Kanta FHIR-rajapinnan REST tarkennukset (HTTP header, JSON Web Token, HTTP body)
- Kanta FHIR sähköinen allekirjoitus (JSON Web Signature, JSON muotoisen datan sähköinen allekirjoitus)
- Yhteiset FHIR artefaktit (profiilit, laajennokset, arvojoukot, koodistot, narratiiviohjeistukset)
Tämä soveltamisopas noudattaa paketin fi.kela.kanta.r4 1.0.0-rc7 mukaisia FHIR artefakteja.
Jäädytetyt soveltamisoppaiden ja FHIR artefaktien versiot:
- Soveltamisoppaiden versiot (ja versiohistoria): Kanta yhteisten FHIR- ja REST-rajapintamäärittelyjen soveltamisoppaiden versiot.
- FHIR artefaktien versiopaketit (ja versiohistoria): Kanta yhteisten FHIR- ja REST-rajapintamäärittelyjen FHIR artefaktien paketit.
- Soveltamisoppaan tietty jäädytetty versio on sidottu aina tiettyyn jäädytettyyn FHIR artefaktien versioon.
Yhteystiedot
FHIR-rajapinnan toteutukseen ja tähän oppaaseen liittyvät kysymykset voi laittaa sähköpostilla osoitteeseen kanta@kanta.fi.
Versiohistoria
| Versionumero | Päivämäärä | Muutokset | Tekijä |
|---|---|---|---|
| 0.9 | 28.5.2024 | Ensimmäinen julkaistu draft-versio | Kela, Kanta-palvelut |
| 0.9.1 | 15.10.2024 | Tarkennettu sivua "Kanta rajapinnan virhevastaus" | Kela, Kanta-palvelut |
| 1.0.0-rc4 | 9.10.2025 | Lisätty sivulle uusia FHIR artefakteja. Terminologiassa yleisesti huomioitavia asioita koodistojen käytöstä. Lisätty sivulle Kanta FHIR rajapinnan REST tarkennukset oma kohtansa Kanta FHIR rajapintojen tietoturva. Lisätty oma kohtansa FHIR narratiivien käytöstä. | Kela, Kanta-palvelut |
| 1.0.0-rc5 | 20.11.2025 | Lisätty uudet profiilit MitatointiProvenanceV2 ja KantaOrganization. Lisätty ValueSet figen-vs-relatedpersonrole. Poistettu profiileista snaphsot-elementit. | Kela, Kanta-palvelut |
| 1.0.0-rc6 | 19.3.2026 | Tätä versiota ei koskaan julkaistu. | Kela, Kanta-palvelut |
| 1.0.0-rc7 | 20.3.2026 | Päivitetty seuraavia profiileja: Kanta Patient version 2 (muutettu identifier- ja name-elementit pakollisiksi, name-elementin sisällä given ja family on muutettu pakollisiksi), Kanta Patient Official (samat muutokset kuin Kanta Patient version 2), MitatointiProvenance2 (agent-rakenteeseen on lisätty slicet ServiceProvider ja SeviceDeliverer, lisätty agent Custodian (rekisterinpitäjä), lisäksi agent-rakenteen who-viittauksista on poistettu turhat profiiliviittaukset), KantaPractitionerV2 (muutettu name-elementti pakolliseksi ja elementin sisällä given ja family muutettu pakollisiksi). |