FHIR API Connectivity

Status	ACTIVE
Since	28. August, 2024
Document version	1

This page outlines connectivity to PKB’s FHIR API which allows clients to send and access data in FHIR format.

TODO: add link to legacy FHIR API

This covers AQS.

Overview

We are in the process of consolidating our FHIR APIs. During this transitional period different resources will be available via different/multiple endpoints/URLs.

Currently, we have four different endpoints:

Aggregated read-only endpoint,
Customer read/write endpoint,
Facade read-only FHIR DEPRECATING,
Demographics write-only FHIR endpoint DEPRECATING .

Connectivity wise

Aggregated / Customer endpoints and
Facade / Demographics FHIR endpoints

are exposed using the mechanisms, hence the same parameters apply to them.

TODO: Add links to the API docs of these endpoints ?

Testing

Sandbox

Click to expand for more details on Sandbox

Aggregated/Customer FHIR endpoints

Differences

Aggregated	https://aggregated-fhir.sandbox.patientsknowbest.com
Customer	`https://<customer>.sandbox.patientsknowbest.com`

Commonalities

Address	Error rendering macro 'excerpt-include' : No link could be created for 'IP addresses'.
Supported TLS versions	Error rendering macro 'excerpt-include' : No link could be created for 'TLS parameters'.
Certificate Issuer
Subject CN	`*.patientsknowbest.com`
Supported cipher suites	Error rendering macro 'excerpt-include' : No link could be created for 'Supported cipher suites by ingress types'.

Production

EDU

Click to expand for more details on edu

URL	https://aggregated-fhir.edu.patientsknowbest.com
Address	Error rendering macro 'excerpt-include' : No link could be created for 'IP addresses'.
Supported TLS versions	`TLSv1.2`, `TLSv1.3`
Supported cipher suites	Error rendering macro 'excerpt-include' : No link could be created for 'Supported cipher suites by ingress types'.

EU

Click to expand for more details on eu

URL	https://aggregated-fhir.eu.patientsknowbest.com
Address	Error rendering macro 'excerpt-include' : No link could be created for 'IP addresses'.
Supported TLS versions	`TLSv1.2`, `TLSv1.3`
Supported cipher suites	Error rendering macro 'excerpt-include' : No link could be created for 'Supported cipher suites by ingress types'.

UK

Click to expand for more details on eu

URL	https://aggregated-fhir.uk.patientsknowbest.com
Address	Error rendering macro 'excerpt-include' : No link could be created for 'IP addresses'.
Supported TLS versions	`TLSv1.2`, `TLSv1.3`
Supported cipher suites	Error rendering macro 'excerpt-include' : No link could be created for 'Supported cipher suites by ingress types'.