启动设备
最近更新时间：2025-02-21 02:50:53
1. 接口描述
接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制：500次/秒。
RTSP拉流设备：按需拉流，手动启动设备，平台进行RTSP拉流。
RTSP推流设备：按需推流，手动启动设备，平台生成RTSP推流地址。
2. 请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | StartDevice | 操作接口名，系统规定参数。 |
| InProtocol | String | 是 | rtsp | 使用的接入协议。 取值: rtsp |
| InType | String | 是 | pull | 视频流接入方式。 取值: push, pull 取值为push，推流； 取值为pull，拉流。 |
| DeviceId | String | 是 | 32388487739092997 | 设备ID。 |
3. 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| DeviceId | String | 设备ID。 |
| PushUrl | String | 推流URL，InType设置为push时，该字段才有效。 rtmp://127.0.0.1:1935/live/32388487739092997?AccessKeyId=O0G0BPBI2T9YUD3U****&Signature=X7rcepN999hy8YlT375NlOcnb7M%3D |
| CreatedTime | String | 启动设备任务创建时间。 |
| UpdatedTime | String | 启动设备任务更新时间。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
4.1 请求示例
https://vssapi.ctyun.cn/
?Action=StartDevice
&InProtocol=rtsp
&InType=pull
&DeviceId=32388487739092997
&Version=2020-06-12
&AccessKeyId=O0G0BPBI2T9YUD3U****
&Signature=M7rcepN979hy2YlT375NlOcnb7M%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=635429707
&SignatureVersion=1.0
&Timestamp=1599095835
4.2 返回示例
{
"DeviceId": "29942058487644187",
"PushUrl":"rtmp://127.0.0.1:1935/live/32388487739092997?AccessKeyId=O0G0BPBI2T9YUD3U****&Signature=X7rcepN999hy8YlT375NlOcnb7M%3D",
"CreatedTime": "2020-09-02 18:27:22",
"UpdatedTime": "2020-09-02 18:27:22",
"RequestId": "b8ce1ab26af942c0a8b220026614064b"
}
5. 错误码
| ErrorCode | ErrorMessage |
|---|---|
本页目录：