w3c/websub

clarification of the use of "POSTed"

aaronpk opened this issue · 1 comments

6.1.1: “For event notification, the callback URL will be POSTed to including any query string parameters in the URL portion of the request, not as POST body parameters.”

This "will be POSTed to" is very confusing, especially because it already needs creativity to remove the query part from a URL and put it somewhere else...

Proposal: "Event notifications are POST requests to the callback URL, including all query parameters given by the subscriber."


From #127 by @mkovatsc

I agree this sentence is confusing. However your interpretation of it was not as intended. The intent is that the POST request is made to the exact callback URL, leaving any query parameters in the URL, not moving them. How about this text instead?

When sending the content distribution request, the hub will make a POST request to the callback URL including any query string parameters in the URL portion of the request, not as POST body parameters.