StatusIn development. API spec subject to change. OverviewPKB implements the $process-message operation as defined by the FHIR specification, in order to allow a client to submit a message for processing.
PKB will outline a MessageDefinition for each event that we support. Some behaviour will be common to all messages as part of the general $process-message specification. Each message will have its own business logic rules defined in the corresponding message definition.
The first message PKB will support is the ability to create or update a patient's demographics, including triggering an email invitation.
PKB only supports the asynchronous pattern, see below for more information.
Synchronous Messaging is not supported by PKB. All Messaging clients must therefore support the asynchronous pattern. This has a few implications:
Transport-level acknowledgementsAn inbound message will have only lightweight validation applied before the transport-level (synchronous) response is returned - just enough to accept the message into the system.
If it passes, then HTTP 202 Accepted (no body) will be returned. Otherwise, an appropriate HTTP error code will be returned, along with a FHIR OperationOutcome where possible.
Application-level acknowledgementsAll other validation is applied afterwards, and any errors will be returned from the application-level (asynchronous) response. PKB will return exactly one response for each inbound message.
Supported messagesSee the FHIR API Messages page for details of supported messages.
Endpoints
|