启动设备拉流

最近更新时间:2025-02-21 02:50:53

1. 接口描述

接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制:500次/秒。

启动设备拉流,会启动设备上的所有流。

2. 请求参数

参数类型是否必选示例值描述
ActionStringStartDevice操作接口名,系统规定参数。
InProtocolStringgb28181使用的接入协议。
取值: gb28181
DeviceIdString32388487739092996设备ID。

3. 返回参数

参数类型描述
DeviceIdString设备ID。
PushUrlString推流URL,InType设置为push时,该字段才有效。
rtmp://127.0.0.1:1935/live/32388487739092997?AccessKeyId=O0G0BPBI2T9YUD3U****&Signature=X7rcepN999hy8YlT375NlOcnb7M%3D
CreatedTimeString启动设备拉流任务创建时间。
UpdatedTimeString启动设备拉流任务更新时间。
RequestIdString唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

4.1 请求示例

https://vssapi.ctyun.cn/
?Action=StartDevice
&InProtocol=gb28181
&DeviceId=29941970440815198
&Version=2020-06-12
&AccessKeyId=O0G0BPBI2T9YUD3U****
&Signature=EXwEUQpWriyFdV9RirssWAe9gow%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=58890601
&SignatureVersion=1.0
&Timestamp=1599042433

4.2 返回示例

{
  "DeviceId":"29941970440815198",
  "CreatedTime":"2022-10-19 17:22:09",
  "UpdatedTime":"2022-10-19 17:22:09",
  "PushUrl":"",
  "RequestId":"de59222aac5d4baeb067cdef6a50e631"
}

5. 错误码

ErrorCodeErrorMessage