Recording Start/End Event Callback Notification
Updated: 2026-07-06 14:19:25
Purpose
When using this feature, after a seminar starts or ends recording, the server will send a notification to the callback URL set by the customer via POST JSON to the user-defined callback interface.
Details
Once the callback URL is configured, the callback will be triggered when the following recording events occur in the seminar:
- Start Recording:
seminar_record_start - End Recording:
seminar_record_stop
The callback request will pass business parameters in JSON Body, and append the timestamp and sign parameters to the callback URL, for example:
POST http://abc.com/test.do?timestamp=1720000000000&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
{
"eventId": "f0f6d3f6f4f14b1bb58b69c4e2a2e9d3",
"eventType": "seminar_record_start",
"eventTime": "1720000000123",
"triggerType": "manual",
"channelId": "12345678",
"channelName": "研讨会演示频道",
"seminarId": "seminar-demo-001"
}
Callback Parameter Description
URL Query Parameters
| Parameter | Type | Description |
|---|---|---|
| timestamp | Long | 13-digit timestamp |
| sign | String | Encrypted string for verification. The generation rule is md5(AppSecret+timestamp), where AppSecret is the live streaming system application secret |
JSON Body Parameters
| Parameter | Type | Description |
|---|---|---|
| eventId | String | Unique event identifier, which the customer system can use for deduplication |
| eventType | String | Event typeseminar_record_start: Start recordingseminar_record_stop: End recording |
| eventTime | String | Time when the event occurred as recorded by the server, 13-digit timestamp |
| triggerType | String | Trigger methodmanual: Manual recordingauto: Automatic recording |
| channelId | String | Live channel ID or live room ID |
| channelName | String | Live channel name |
| seminarId | String | Unique seminar identifier, returned only when the current seminar has a unique identifier |
Notes
- If the interface does not return HTTP Status 200, the callback will be considered failed. In case of failure, it will retry 3 times.
- The callback retry intervals are 5 seconds, 10 seconds, and 15 seconds respectively.
eventIdgenerates a new unique value each time an event is triggered. It is recommended that the business side implement idempotent processing.
How to Set Up
Set up via the backend:
Log in to your account - Go to [Cloud Live] - Click [Developer Settings] - Click [Callback Settings] - Seminar Event Callback URL
Note: The submitted interface address must start with http:// or https://.
