[Doc] Update websocket docs to suggest passing the token as headers rather than query parameters

[lhotari]

Search before asking

• I searched in the issues and found nothing similar.

What issue do you find in Pulsar docs?

https://pulsar.apache.org/docs/4.0.x/client-libraries-websocket/#authentication

What is your suggestion?

suggest passing the token as headers rather than query parameters

Any reference?

No response

Are you willing to submit a PR?

• I'm willing to submit a PR!

[walkinggo]

I want to do it if no one want. could you assign it to me? @lhotari

[lhotari]

I want to do it if no one want. could you assign it to me? @lhotari

sure, please go ahead. Just a tip: using generative AI such as ChatGPT is good for fixing grammar issues.

[lhotari]

@walkinggo You should first update the documentation files in the docs directory and then in the versioned_docs ONLY for supported versions (version-4.0.x and version-3.0.x). More details in https://github.com/apache/pulsar-site?tab=readme-ov-file#updating-versioned-docs and https://pulsar.apache.org/contribute/document-contribution/#update-versioned-docs .

[walkinggo]

Thank you ! I will try my best to finish it.

[walkinggo]

I would like to resolve this issue, but could you please explain the reason? You suggested passing the token as a header rather than as a query parameter, but why is that the case? @lhotari

[walkinggo]

@walkinggo You should first update the documentation files in the docs directory and then in the versioned_docs ONLY for supported versions (version-4.0.x and version-3.0.x). More details in https://github.com/apache/pulsar-site?tab=readme-ov-file#updating-versioned-docs and https://pulsar.apache.org/contribute/document-contribution/#update-versioned-docs .

take a look,please. pr981