| Package | hl7.fhir.uv.subscriptions-backport |
| Resource Type | OperationDefinition |
| Id | backport-subscription-get-ws-binding-token |
| FHIR Version | R4B |
| Source | http://hl7.org/fhir/uv/subscriptions-backport/https://build.fhir.org/ig/HL7/fhir-subscription-backport-ig/OperationDefinition-backport-subscription-get-ws-binding-token.html |
| URL | http://hl7.org/fhir/uv/subscriptions-backport/OperationDefinition/backport-subscription-get-ws-binding-token |
| Version | 1.2.0-ballot |
| Status | active |
| Date | 2020-11-30 |
| Name | R5SubscriptionGetWsBindingToken |
| Title | Get WS Binding Token for Subscription Operation |
| Realm | uv |
| Authority | hl7 |
| Description | This operation is used to get a token for a websocket client to use in order to bind to one or more subscriptions. |
| Type | true |
| Kind | operation |
| CapabilityStatement | |
| r4-capabilitystatement-example-server | |
| backport-subscription-server-r4 | R4 Topic-Based Subscription Server Capability Statement |
| backport-subscription-server | R4B Topic-Based Subscription Server Capability Statement |
No resources found
Note: links and images are rebased to the (stated) source
URL: [base]/Subscription/$get-ws-binding-token
URL: [base]/Subscription/[id]/$get-ws-binding-token
Parameters
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | id | 0..* | id | 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. | ||
| OUT | token | 1..1 | string | An access token that a client may use to show authorization during a websocket connection. | ||
| OUT | expiration | 1..1 | dateTime | The date and time this token is valid until. | ||
| OUT | subscription | 0..* | string | The subscriptions this token is valid for. | ||
| OUT | websocket-url | 1..1 | url | The URL the client should use to connect to Websockets. |
{
"resourceType": "OperationDefinition",
"id": "backport-subscription-get-ws-binding-token",
"text": {
"status": "extensions",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
"valueInteger": 0
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "trial-use"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "fhir"
}
],
"url": "http://hl7.org/fhir/uv/subscriptions-backport/OperationDefinition/backport-subscription-get-ws-binding-token",
"version": "1.2.0-ballot",
"name": "R5SubscriptionGetWsBindingToken",
"title": "Get WS Binding Token for Subscription Operation",
"status": "active",
"kind": "operation",
"date": "2020-11-30",
"publisher": "HL7 International / FHIR Infrastructure",
"contact": [
{
"name": "HL7 International / FHIR Infrastructure",
"telecom": [
{
"system": "url",
"value": "http://www.hl7.org/Special/committees/fiwg"
}
]
},
{
"name": "Gino Canessa",
"telecom": [
{
"system": "email",
"value": "mailto:gino.canessa@microsoft.com"
}
]
}
],
"description": "This operation is used to get a token for a websocket client to use in order to bind to one or more subscriptions.",
"jurisdiction": [
{
"coding": [
{
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code": "001",
"display": "World"
}
]
}
],
"affectsState": false,
"code": "get-ws-binding-token",
"resource": [
"Subscription"
],
"system": false,
"type": true,
"instance": true,
"parameter": [
{
"name": "id",
"use": "in",
"min": 0,
"max": "*",
"documentation": "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.",
"type": "id"
},
{
"name": "token",
"use": "out",
"min": 1,
"max": "1",
"documentation": "An access token that a client may use to show authorization during a websocket connection.",
"type": "string"
},
{
"name": "expiration",
"use": "out",
"min": 1,
"max": "1",
"documentation": "The date and time this token is valid until.",
"type": "dateTime"
},
{
"name": "subscription",
"use": "out",
"min": 0,
"max": "*",
"documentation": "The subscriptions this token is valid for.",
"type": "string"
},
{
"name": "websocket-url",
"use": "out",
"min": 1,
"max": "1",
"documentation": "The URL the client should use to connect to Websockets.",
"type": "url"
}
]
}