Start forwarding a stream to CDN

Last updated：2022-03-22 13:07

1 Description

Starts forwarding the specified stream from ZEGO's RTC server to the specified CDN URL. Perform this step before starting to publish the stream.

2 Request method and endpoint

Request method: GET
Request endpoint: https://rtc-api.zego.im/?Action=CreatCDNTransferRule
Transmission protocol: HTTPS
Rate limit: 10 requests/second (Testing environment: 5 requests/second)

3 Request parameters

Listed below are the parameters specific to this request and part of the public request parameters. For the complete list of public request parameters, see Server APIs public request parameters.

Parameter	Type	Required	Description
StreamId	String	Yes	Stream ID.
CDNUrl	String	Yes	The CDN URL (in RTMP format) to which the stream is to be forwarded.
Sequence	String	Yes	Request sequence number. Requests must be sent with the request sequence number in ascending order. It is recommended to use a timestamp (in milliseconds) as the request sequence number.

4 Sample request

https://rtc-api.zego.im/?Action=CreatCDNTransferRule
&StreamId=rtc01
&CDNUrl=rtmp%3A%2F%2Fwsdemo.zego.im%2Flivestream%2Frtc01
&Sequence=1617249600001
&<Public Request Parameters>

5 Response parameters

Parameter	Type	Description
Code	Number	Return code.
Message	String	Description of the request execution result.
RequestId	String	Request ID.
Data	Object	Returned data.

6 Sample response

{
    "Code":0,
    "Message":"ok",
    "RequestId":"918334131114317411",
    "Data":null
}

7 Return codes

Listed below are the return codes related to this API. For the complete list of return codes, see Return codes.

Return code	Description
41001	Failed to save live stream.
41002	Failed to save channel.
41003	Live stream does not exist.
41004	Stream no longer exists.
42001	Failed to forbid live stream.
42002	Failed to resume live stream.
42003	Batch disable live broadcast failed.
42004	Failed to resume live streaming in batches.
43001	Failed to create recording index file.