FHIRcast logo

FHIRcast
3.0.0-ballot - STU 3 Ballot International flag

FHIRcast, published by HL7 International / Infrastructure And Messaging. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhircast-docs/ and changes regularly. See the Directory of published versions

HeartBeat Event

Implementer feedback is requested for the need to support Heartbeat.htmls for WebSockets.

Event-name: Heartbeat event

eventMaturity 1 - Submitted

Workflow

The Heartbeat.html event is sent regularly by the Hub to indicate that a connection should remain open. This event SHALL be sent at least every 10 second, or an order of magnitude lower than the subscription time-out.

Context

The context of the Heartbeat.html event described in the table below.

Key Optionality # type Description
period REQUIRED 1 decimal The maximum resend period in seconds

The period field indicates the repeat interval. If an event is not received within this time period, the connection may be assumed to be lost.

Example

An example Heartbeat.html event is indicated below.

{
  "timestamp":"2021-05-19T10:24:58.614989800Z",
  "id":"sdkasldkals;610101498614",
  "event":{
    "context":[
      { "key":"period",
        "decimal": "10"
      }
    ],
    "hub.topic":"Topic1",
    "hub.event":"Heartbeat.html"
  }
}

Change Log

Version Description
1.0 Initial Release