Stream Status Callbacks
Last update：2026-07-03 11:00:49
Stream Status Callbacks lets you receive real-time callback notifications when a stream starts or ends in Media Acceleration Live Broadcast. This guide explains how to enable callbacks for a live push domain, configure start and end callback URLs, and select the callback parameters sent with each event.
Use this feature when your application needs to synchronize stream lifecycle events with an external service, such as a monitoring system, workflow system, or business backend.
Before you begin
- You have access to the CDNetworks console account that owns the Media Acceleration Live Broadcast domain.
- The domain you configure is a push domain, because stream start and end callbacks are tied to ingest events.
- You have prepared reachable callback endpoints for stream start and stream end events.
- The stream start URL and stream end URL use the same protocol and domain.
- You know which callback parameters your external service expects.
Configure stream status callbacks
Configure stream status callbacks from the domain configuration editor.
-
Go to Media Delivery > Media Acceleration Live Broadcast > Configuration.
-
In the domain list, find the push domain that you want to configure, then choose Edit Configuration.
-
In the configuration editor, choose Stream Status Callbacks, then choose Add.
If Add is not visible, a stream status callback configuration may already exist for the domain. Review the existing Stream Status Callbacks row instead.
-
For Stream Status Callbacks, select On.
-
Configure the callback settings.
| Field | Required | Default | Description |
|---|---|---|---|
| Stream Status Callbacks | Yes | Off | Enables or disables callback reporting for stream start and end events. Options are On and Off. |
| Method | Yes | GET | The HTTP method used to send callback requests. Options are GET and POST. |
| Stream Start URL | Yes | None | The callback URL that receives stream start events. Enter the full URL, including protocol, host or domain, optional port, and path. |
| Stream End URL | Yes | None | The callback URL that receives stream end events. Enter the full URL, including protocol, host or domain, optional port, and path. |
| Callback Parameters | No | See default selections | Select the parameters to include and edit the parameter names if your endpoint expects custom names. |
Important: The stream start URL and stream end URL must use the same protocol and domain. For example, configure both URLs under the same
https://example.comhost.
- Under Callback Parameters, expand Click configure. In Report Starts and Report Ends, select the parameters to send with stream start and stream end callbacks.
- Choose Confirm, review the Stream Status Callbacks row in the editor, then choose Next only when you are ready to review the full domain configuration.
Reference
Callback URL format
Use the following format for callback URLs:
{protocol}://{host}:{port}/{URI}
Examples:
https://test.example.com/api/live/check
http://1.1.1.1:8888/api/live/check
Callback parameters
You can configure callback parameters separately for Report Starts and Report Ends.
Callback parameters define the event information sent to your callback endpoint when a stream starts or ends. For each event type, you can keep the default parameter names or change them to match the names expected by your service. Clear a parameter if you do not want it included in the callback request.
| Parameter | Default name | Default selection | Description |
|---|---|---|---|
| Client IP | ip |
Selected | IP address of the client that triggered the stream event. |
| CDN Edge IP | node |
Selected | IP address of the CDN edge node that handled the stream event. |
| Stream Name | id |
Selected | Name of the stream that triggered the callback. |
| Host | app |
Selected | Host value associated with the stream event. |
| Application Name | appname |
Selected | Application name or publishing point associated with the stream. |
| MD5 | None | Not selected | MD5 value included with the callback when selected. |
| Connection Port | port |
Selected | Port used for the stream connection. |
| Timestamp (s) | None | Selected | Event timestamp in seconds. |
| Timestamp (ms) | milltime |
Not selected | Event timestamp in milliseconds. |
| Others | None | Optional | Custom parameter names to include in the callback. Separate multiple values with ;. |