This page is part of the Subscriptions R5 Backport (v1.1.0: STU 1.1) based on FHIR v4.3.0. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Subscriptions are operations which typically involve two or three actors:
Any FHIR application may support the use of Subscriptions. In this documentation:
Server refers to the FHIR application or applications acting as the subscription provider. This includes the responsibilities of implementing one or more SubscriptionTopics
, managing Subscriptions
, and sending notifications.
Note that when using subscriptions, the FHIR server combines the roles of publisher and information distributer. Some arrangements of the ‘publish and subscribe’ pattern describe separate agents for the two roles. This specification makes no recommendations towards the internal architecture of server implementations.
Client refers to the FHIR application or applications acting as subscriber. This includes the responsibilities of acting as a FHIR client (to create a Subscription) and receiving notifications on a supported channel.
Endpoint refers to the portion of the client which is responsible for receiving notifications, if applicable. For example, when using the rest-hook
channel type the endpoint is the HTTP server listening for notifications.
Note that while part of the client, it is often useful to refer to the endpoint separately for clarity. This specification makes no recommendations towards the internal architecture of client implementations.