$get-ws-binding-token

R5SubscriptionGetWsBindingToken

activeSubscriptions Backport1.1.0operation1 input4 outputs

This operation is used to get a token for a websocket client to use in order to bind to one or more subscriptions.

Metadata

hl7.org/fhir
Canonical URL
http://hl7.org/fhir/uv/subscriptions-backport/OperationDefinition/backport-subscription-get-ws-binding-token
Code
$get-ws-binding-token
Kind
operation
Affects State
No
Publisher
HL7 FHIR Infrastructure WG

Invocation Context

Can be invoked at:
Type LevelInstance Level
Target Resources:
Subscription
Affects State:No

Input Parameters (1)

NameTypeCard.Description
idid0..*At the Instance level, this parameter is ignored. At the Resource level, one or more parameters containing a FHIR id for a Subscription to get a token for. In the absense of any specified ids, the server may either return a token for all Subscriptions available to the caller with a channel-type of websocket or fail the request.

Output Parameters (4)

NameTypeCard.Description
tokenstring1..1An access token that a client may use to show authorization during a websocket connection.
expirationdateTime1..1The date and time this token is valid until.
subscriptionstring0..*The subscriptions this token is valid for.
websocket-urlurl1..1The URL the client should use to connect to Websockets.

Additional Information

Version
1.1.0
Date
2020-11-30