Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-25816

Remove sentence "•Subscriber requests a subscription at the hub.url url."

    XMLWordPrintableJSON

    Details

    • Type: Change Request
    • Status: Applied (View Workflow)
    • Priority: Highest
    • Resolution: Not Persuasive with Modification
    • Specification:
      FHIRCast (FHIR)
    • Raised in Version:
      0.1
    • Work Group:
      Imaging Integration
    • Related Page(s):
      (NA)
    • Related Section(s):
      Subscribing and Unsubscribing
    • Grouping:
    • Resolution Description:
      Hide

      The text refers to the two exchanges being

      1. Subscription request 
      2. Subscription confirmation

      The focus is not on the difference between web socket and web hooks, but that there are two exchanges involved in creating a subscription.

       Suggestion is to reword the phrase to make this more clear:

       

      Existing wording: 

       

      Subscribing consists of two exchanges:

      • Subscriber requests a subscription at the hub.url url.
      • For hub.channel.type = webhook, Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url.
      • For hub.channel.type = websocket, Hub returns a wss url and subscriber establishes websocket connection.

      Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe.

      Proposed wording:

      Subscribing consists of two exchanges:

      • Subscriber requests a subscription at the hub.url url.
      • The hub confirms the subscription was actually requested by the subscriber. This exchange can be implemented in two ways depending on the channel type.
        • For hub.channel.type = webhook, Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url.
        • For hub.channel.type = websocket, Hub returns a wss url and subscriber establishes websocket connection.

      Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe.

      Show
      The text refers to the two exchanges being Subscription request  Subscription confirmation The focus is not on the difference between web socket and web hooks, but that there are two exchanges involved in creating a subscription.  Suggestion is to reword the phrase to make this more clear:   Existing wording:     Subscribing consists of two exchanges: Subscriber requests a subscription at the hub.url url. For hub.channel.type = webhook , Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url. For hub.channel.type = websocket , Hub returns a wss url and subscriber establishes websocket connection. Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe. Proposed wording: Subscribing consists of two exchanges: Subscriber requests a subscription at the hub.url url. The hub confirms the subscription was actually requested by the subscriber. This exchange can be implemented in two ways depending on the channel type. For hub.channel.type = webhook , Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url. For hub.channel.type = websocket , Hub returns a wss url and subscriber establishes websocket connection. Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe.
    • Resolution Vote:
      Isaac Vetter / Eric Martin : 5-0-0
    • Change Category:
      Clarification
    • Change Impact:
      Non-substantive

      Description

      Remove sentence "•Subscriber requests a subscription at the hub.url url.". Focus is on difference between webhook and websocket not on where to send.

      Existing Wording:

      • Subscriber requests a subscription at the hub.url url.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              niklas_svenzen Niklas Svenzen
              Reporter:
              bvdh Bas van den Heuvel
              Watchers:
              3 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:
                Vote Date: