Beschrijving

...

De FHIR service MOET de FHIR versie bekend maken, dit kan door de volgende methoden:

1. Capability Statement van de FHIR resource service. Deze methode is verplicht. In het capability statement staat de versie in het fhirVersion veld. 

   
   

   Code Block
   { "resourceType": "CapabilityStatement", "fhirVersion": "4.0.1", ... }

   
   

2. De FHIR versie onderdeel te maken van de MIME-type als parameter in zowel de Accept header als de Content-Type header. Deze methode is optioneel.

   Code Block
   Accept: application/fhir+json; fhirVersion=4.0

   
   

3. De FHIR versie in de URL van de FHIR service als pad toe te voegen in de URL. Deze methode is optioneel. Een voorbeeld voor versie 4.0.1 ziet er als volgt uit:

   Code Block
   https://fhir.example.com/fhir/<domain>/4.0.0/metadata

   
   

...

De FHIR client mag gebruik maken van de fhirVersion parameter in de Content-Type  header of Accept header, maar is dit niet verplicht. De FHIR resource service moet deze valideren met de eigen FHIR versie, met uitzondering van een conversie scenario. Van dit laatste scenario wordt in koppeltaal geen gebruik gemaakt.

API versionering. 

Ook de verdere APIs in het domein, zoals de autorisatie service, mogen in hun URL de versie van hun API verwerken. Indien dit gedaan wordt, moet dit volgens het volgende nummersysteem gedaan worden:

...