This page is part of the FHIR Specification (v1.6.0: STU 3 Ballot 4). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3
Detailed Descriptions for the elements in the Endpoint resource.
Endpoint | |
Definition | The technical details of an endpoint that can be used for electronic services, such as for web services providing XDS.b or a REST endpoint for another FHIR server. This may include any security context information. |
Control | 1..1 |
Endpoint.identifier | |
Definition | Identifier for the organization that is used to identify the endpoint across multiple disparate systems. |
Note | This is a business identifer, not a resource identifier (see discussion) |
Control | 0..* |
Type | Identifier |
Summary | true |
Endpoint.status | |
Definition | active | suspended | error | off. |
Control | 1..1 |
Binding | EndpointStatus: The status of the encounter. (Required) |
Type | code |
Is Modifier | true |
Summary | true |
Endpoint.name | |
Definition | A friendly name that this endpoint can be referred to with. |
Control | 0..1 |
Type | string |
Summary | true |
Endpoint.managingOrganization | |
Definition | The organization that manages this endpoint (even if technically another organisation is hosting this in the cloud, it is the organisation associated with the data). |
Control | 0..1 |
Type | Reference(Organization) |
Summary | true |
Comments | This property is not typically used when searching for Endpoint resources for usage. The typical usage is via the reference from an aplicable Organization/Location/Practitioner resource, which is where the context is provided. Multiple Locations may reference a single endpoint, and don't have to be within the same organization resource, but most likely within the same organizational heirarchy. |
Endpoint.contact | |
Definition | Contact details for a human to contact about the subscription. The primary use of this for system administrator troubleshooting. |
Control | 0..* |
Type | ContactPoint |
Endpoint.connectionType | |
Definition | The type of channel to send notifications on. |
Control | 1..1 |
Binding | SubscriptionChannelType: The type of the subscription. (Extensible) |
Type | Coding |
Summary | true |
To Do | Just as with subscription, should harmonize with http://hl7.org/fhir/ValueSet/message-transport. |
Endpoint.method | |
Definition | The http verb to be used when calling this endpoint. |
Control | 0..* |
Binding | HTTPVerb: (Extensible) |
Type | Coding |
Summary | true |
Comments | This is the HTTP method that must be used when using the connection. |
To Do | Should this be single, or multiple cardinality? |
Endpoint.period | |
Definition | The interval during which the managing organization assumes the defined responsibility. |
Control | 0..1 |
Type | Period |
Summary | true |
Endpoint.address | |
Definition | The uri that describes the actual end-point to send messages to. |
Control | 1..1 |
Type | uri |
Summary | true |
Comments | For rest-hook, and websocket, the end-point must be an http: or https: URL; for email, a mailto: url, for sms, a tel: url, and for message the endpoint can be in any form of url the server understands (usually, http: or mllp:). The URI is allowed to be relative; in which case, it is relative to the server end-point (since their may be more than one, clients should avoid using relative URIs). |
Endpoint.payloadFormat | |
Definition | The mime type to send the payload in - either application/fhir+xml, or application/fhir+json. If the mime type is blank, then there is no payload in the notification, just a notification. |
Control | 1..1 |
Type | string |
Comments | Sending the payload has obvious security consequences. The server is responsible for ensuring that the content is appropriately secured. |
To Do | Should this have multiple cardinality? |
Endpoint.payloadType | |
Definition | The payload type describes the acceptable content that can be communicated on the endpoint. |
Control | 1..* |
Binding | Endpoint Payload Type: (Example) |
Type | CodeableConcept |
Summary | true |
Comments | The payloadFormat describes the wire format of the data, where the payloadType indicates the specific document/schema that is being transferred. E.g. DischargeSummary or CarePlan. |
Endpoint.header | |
Definition | Additional headers / information to send as part of the notification. |
Control | 0..* |
Type | string |
Comments | Exactly what these mean depend on the channel type. The can convey additional information to the recipient and/or meet security requirements. |
Endpoint.publicKey | |
Definition | The public part of the 'keys' allocated to an Organization by an accredited body to support secure exchange of data over the internet. To be provided by the Organization, where available. |
Control | 0..1 |
Type | string |