Start a cloud recording task
Updated
Starts a cloud recording task with an acquired resource ID.
https://api.sd-rtn.com/v1/apps/{appid}/cloud_recording/resourceid/{resourceid}/mode/{mode}/startAfter receiving a resource ID from acquire, call this endpoint within five minutes to start cloud recording.
Note
After calling start, check that the recording service has started successfully. See Integration best practices.
Path Parameters
The App ID of your project.
- For web page recording mode, enter the App ID for which the cloud recording service is enabled.
- For individual and composite recording modes, use the same App ID as the channel to be recorded. Ensure that the cloud recording service has been enabled for this App ID.
The resource ID obtained from the acquire endpoint.
The recording mode:
individual: Individual recording mode.mix: Composite recording mode.web: Web page recording mode.
individual | mix | webHeader Parameters
Request Body
application/json
The name of the channel to record. Must match the cname used in the acquire request.
The UID used by the cloud recording service in the channel. Must match the uid used in the acquire request.
Response
-
If the returned status code is
200, the request was successful. -
If the returned status code is not
200, the request failed. See Response status codes for troubleshooting.
Response Body
application/json
Response schema
200application/jsonThe request succeeded. To confirm that the recording service started successfully, follow the integration best practices.
The cloud recording resource ID. Valid for five minutes; re-request from acquire if expired.
The resource ID used by cloud recording.
The recording ID. Uniquely identifies a recording session. Generated after the cloud recording service starts successfully.
The recording ID, identifying the current recording session.
The name of the channel to be recorded.
The name of the channel being recorded.
The UID used by the cloud recording service in the RTC channel.
defaultapplication/jsonThe request failed. If the HTTP status code is not 200, see the Cloud Recording response status codes for troubleshooting.
Response
See Page load timeout detection.
Response example
{
"code": 7,
"reason": "already started"
}
Request examples
curl --request POST \ --url https://api.sd-rtn.com/v1/apps/{appid}/cloud_recording/resourceid/{resourceid}/mode/{mode}/start \ --header 'Authorization: Basic <credentials>' \ --header 'Content-Type: application/json' \ --data '{ "cname": "<your_channel_name>", "uid": "527841", "clientRequest": { "recordingConfig": { "channelType": 1, "streamTypes": 2, "streamMode": "default", "videoStreamType": 0, "maxIdleTime": 30, "subscribeAudioUids": ["123", "456"], "subscribeVideoUids": ["123", "456"], "subscribeUidGroup": 0 }, "recordingFileConfig": { "avFileType": ["hls"] }, "storageConfig": { "vendor": 2, "region": 3, "bucket": "xxxxx", "accessKey": "xxxxx", "secretKey": "xxxxx", "fileNamePrefix": ["directory1", "directory2"] } } }'Response example
{ "cname": "string", "uid": "string", "resourceId": "string", "sid": "string"}