获取设备录像视频取流URL。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 GetDeviceVideoUrl

系统规定参数。取值：GetDeviceVideoUrl。

CorpId String 是 252060345870948****

项目ID，在产品控制台进行创建或者通过CreateCorp来进行创建。
DeviceId String 否 1101050001132700****

设备ID
StorageType String 否 0

视频源。取值范围：

0：存储在VCS云端

1：存储在设备本地

默认为0
StartTime Long 否 1599807533000

开始时间，timestamp格式，毫秒。
EndTime Long 否 1600081668000

结束时间，timestamp格式，毫秒。
OutProtocol String 否 hls

流播放协议，取值范围：

hls

flv

httpshls

httpsflv

rtsp

存储在设备本地时，支持全部协议；

存储在VCS云端时，仅支持 hls 和 httpshls 协议。

此参数不传时，默认为 hls。
GbId String 否 1101050001132700****

已废弃。设备国标编码。请使用DeviceId。

返回数据

名称 类型 示例值 描述
RequestId String 08ebc43f_a815_4ba2_8920_c113b60c66a4

请求ID
Code String 200

请求返回Code
Message String Success

返回结果消息
OutProtocol String hls

流播放协议
Url String http://example.com/xxx

视频回放URL

示例

请求示例

http(s)://[Endpoint]/?Action=GetDeviceVideoUrl
&CorpId=252060345870948****
&DeviceId=1101050001132700****
&StorageType=0
&StartTime=1599807533000
&EndTime=1600081668000
&OutProtocol=hls
&GbId=1101050001132700****
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<GetDeviceVideoUrlResponse>
    <RequestId>08ebc43f_a815_4ba2_8920_c113b60c66a4</RequestId>
    <Code>200</Code>
    <Message>Success</Message>
    <OutProtocol>hls</OutProtocol>
    <Url>http://example.com/xxx</Url>
</GetDeviceVideoUrlResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "08ebc43f_a815_4ba2_8920_c113b60c66a4",
  "Code" : "200",
  "Message" : "Success",
  "OutProtocol" : "hls",
  "Url" : "http://example.com/xxx"
}

错误码

访问错误中心查看更多错误码。