EdgeCloud Video Service: Webhooks
Set up webhooks in the Theta Video API dashboard to receive events about videos and streams.
Types of events that can be subscribed to
| Video | Description |
|---|---|
| video.created | Occurs when a video is created |
| video.updated | Occurs when a video's metadata is updated, or when a video is retried |
| video.partial_finished | Occurs when a video's resolution is finished |
| video.finished | Occurs when all resolutions of a video are finished |
| video.errored | Occurs when an error occurs transcoding a video |
| video.deleted | Occurs when a video is deleted |
Example API request made from Theta Video API to the partner backend
curl -X POST 'https://api.partnerbackend.com/webhooks/tva/recieve' \
-H 'Content-Type: application/json' \
-d '{
"id": "wbhk_evnt_xxxxxxxxxxxxxxxxxxxxxx",
"service_account_id": "srvacc_xxxxxxxxxxxxxxxxxxxxxxxxx",
"object_id": "video_xxxxxxxxxxxxxxxxxxxxxxxxxx",
"object_uri": "https://api.thetadrop.com/video/video_xxxxxxxxxxxxxxxxxxxxxxxxxx",
"event": "video.created",
"create_time": "2023-06-13 18:14:09.4416 +00:00",
"update_time": "2023-06-13 18:14:09.4416 +00:00"
}'
Use the Theta Video API to fetch the object. A URI to the object is added to the event for convenience.
Delivery of events is not guaranteed to be in the same order they were generated.
A 2xx status code response is expected from the partner backend. If the partner backend does not respond with a 2xx status code, the Theta Video API will keep retrying with exponential backoff.
Updated 8 months ago