Document how to test Cloudflare Stream webhooks

[apotek]

Existing documentation URL(s)

• https://developers.cloudflare.com/stream/manage-video-library/using-webhooks/

What changes are you suggesting?

1. Include a full example POST data, not a truncated one, of the kind of response Cloudflare would submit to a developer's registered Webhook. The example given is incomplete, and there is no explanation as to what the various properties are. For example, what is the uid property in the data sent to the Webhook?
2. Document how Cloudflare recommends the development and testing of a Cloudflare Stream webhook. I assumed that by using ngrok, and registering my ngrok URL to Cloudflare, that I would be able to see the incoming Webhook posts in my development environment. But despite registering my ngrok URL, and the registration being successful, I never received any Webhook calls to that URL. Additionally, my ngrok account showed no POST attempts to my ngrok domain from Cloudflare. My test posts from my own command line to my ngrok domain were received so the ngrok domain and setup were working.

How does Cloudflare suggest a developer write and develop and test a Cloudflare Stream Webhook?

Additional information

I see that Cloudflare Tunnel might work, but it requires a developer to have DNS control over the Cloudflare account. Most developers might only have an API token given to them to work with Cloudflare stream with no control over DNS. I do not have DNS control so I can't use Cloudflare Tunnel.

[tsmith512]

Just to be sure --- are you referring to webhooks for on-demand / uploaded videos, or for live broadcasts?

[apotek]

Just to be sure --- are you referring to webhooks for on-demand / uploaded videos, or for live broadcasts?

This is for on-demand/uploaded videos. Thank you.