Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Stu2 add websockets #295

Merged
merged 7 commits into from
Nov 15, 2019
Merged

Stu2 add websockets #295

merged 7 commits into from
Nov 15, 2019

Conversation

isaacvetter
Copy link
Collaborator

First take on formal websocket support in spec.

docs/specification/Feb2020Ballot.md Outdated Show resolved Hide resolved
docs/specification/Feb2020Ballot.md Outdated Show resolved Hide resolved
docs/specification/Feb2020Ballot.md Outdated Show resolved Hide resolved
per Will's review
fix some links and remove references to source diagrams/flowcharts because they're hosted on google drive .... :(
Necessary to correlate event notification "requests" with event notification "responses" -- because, truly, there's no such thing as a request or a response in websockets.
`hub.channel.endpoint` to be included in websockets unsubscribes, callback/secret/challenge only in webhook, clarify additive/subtractive nature of a subscription
for websockets to exchange the same info that intent verification exchanges over webhook
@isaacvetter
Copy link
Collaborator Author

Fixes #299


If OAuth 2.0 authentication is used, this POST request SHALL contain the Bearer access token in the HTTP Authorization header.

Hubs SHALL allow subscribers to re-request subscriptions that are already activated. Each subsequent and verified request to a Hub to subscribe or unsubscribe SHALL override the previous subscription state for a specific topic / callback URL combination.
Hubs SHALL allow subscribers to re-request subscriptions that are already activated. Each subsequent and verified request to a Hub to subscribe or unsubscribe SHALL override the previous subscription state for a specific `hub.topic`, `hub.callback` / `hub.channel.endpoint` url, and `hub.events` combination. For example, a subscriber MAY modify its subscription by subscribing to or unsubscribing from additional events by sending subscription requests for additional events with the same topic and callback/endpoint url.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So are the unique identifying combos topic/callback (for webhook) and endpoint/events (for websocket)? The only real difference between the two methods is the callback and endpoint so shouldn't the rest be the same? So shouldn't topic be included in the websockets uniqueness and what about events for webhook?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Read this wrong, this is what I expected.

@isaacvetter isaacvetter merged commit ce92151 into master Nov 15, 2019
@isaacvetter isaacvetter deleted the stu2-add-websockets branch November 15, 2019 13:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants