状态码： 400
请求错误。具体返回错误码请参考错误码说明
{ "error_msg" : "The entered stream ID does not exist.", "error_code" : "VIS.0202"
}
状态码
状态码 描述
200 请求响应成功
400 请求错误。具体返回错误码请参考错误码说明
5.7 获取视频流地址
功能介绍
此接口用于获取指定视频流的地址。该地址用于进行视频流推流或者拉流。
● 实时视频流，可以通过该接口返回的pull_flow_address参数值获取视频流地址。
● 如果编码格式是H264、H265，均可通过该接口返回的hls_pull_flow_address和 pull_flow_address获取视频流地址。
● 对于RTMP类型的视频流，该接口可以获取到推流地址（对应push_flow_address 参数值），通过该地址，可以将视频流推到VIS中。
当因网络或其它原因，导致视频流中断后自动恢复时，推流地址或拉流地址可能发生 变化。请重新调用该接口，并尝试使用新的推流地址再次进行推流。在灾备场景下，
拉流地址可能会发生变化，导致已获取的相应地址无效，请重新调用该接口获取新的 地址。
为防止接入视频被泄露和盗链，获取的拉流地址中包含防盗链，防盗链的有效期默认 为24小时（后续将支持自定义防盗链有效期）。为避免因防盗链超过有效期导致接入 视频无法播放，请您在有效期内重新调用该接口获取新的防盗链地址。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/streams/{stream_name}/endpoint
表5-33 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID，获取方法请参考获取项 目ID
stream_name 是 String 视频流名称
表5-34 Query 参数
参数 是否必选 参数类型 描述
expire_time 否 Integer 获取的视频流拉流地址的有效时 间，设置范围为[600,604800]，
单位：秒。建议设置为8小时以 内。
默认值24小时。
请求参数
表5-35 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 普通租户的token。
Authorization 否 String 使用AK/SK方式认证时必选，携 带的鉴权信息。
X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请 求的发生时间。
X-Project-Id 否 String 使用AK/SK方式认证时必选，携 带项目ID信息。
响应参数
状态码： 200
表5-36 响应 Body 参数
参数 参数类型 描述
pull_flow_add
ress String 拉流地址，视频流编码格式为H264和H265均会 返回该字段。如果视频流的共享类型为PRIVATE
（非共享），拉流时必须在请求头中添加X-Auth-Token，值为创建视频流的用户的token。
参数 参数类型 描述 push_flow_pr
otocol String 只有RTMP类型的流，该字段才有实际参考意 义，代表推流协议。
push_flow_ad
dress String 只有RTMP类型的流，该字段才有实际参考意 义，代表推流地址。
hls_pull_flow_
address String HLS（HTTP Live Streaming）拉流地址，视频编 码格式为H265和H264均会返回HLS拉流地址。
请求示例
GET /v1/aecdc9b7********9fbc5b04f1d9b525/streams/channel_06640495271320000********/endpoint
响应示例
状态码： 200 请求响应成功
● 示例 1
{ "pull_flow_address" : "https://vps-cn-north-7-cloud.hwcloudvis.com/mss-stable-work001/live?
app=vis&stream=xxxxn&project_id=aecdc9b7********9fbc5b04f1d9b525&key=8930f********15cd409b1b8f be9b8cb&t=1629790048",
"push_flow_protocol" : "HTTP-FLV", "push_flow_address" : "100.95.***.222",
"hls_pull_flow_address" : "https://vps-cn-north-7-cloud.hwcloudvis.com/mss-stable-work001/hls/
xxxxn.m3u8?
project_id=aecdc9b7********9fbc5b04f1d9b525&key=8930f********15cd409b1b8fbe9b8cb&t=1629790048"
}
● 示例 2
{ "push_flow_protocol" : "GB/T28181", "push_flow_address" : "100.95.***.93",
"hls_pull_flow_address" : "https://vps-cn-north-7-cloud.hwcloudvis.com/mss-stable-work002/hls/
channel_06640495271320000********.m3u8?
project_id=aecdc9b7********9fbc5b04f1d9b525&key=6eeea********db10dcf3fa30c20d249&t=1629789339"
, "pull_flow_address" : "https://vps-cn-north-7-cloud.hwcloudvis.com/mss-stable-work002/live?
app=vis&stream=channel_06640495271320000********&project_id=aecdc9b7********9fbc5b04f1d9b525&k ey=6eeea********db10dcf3fa30c20d249&t=1629789339"
}
状态码： 400
请求错误。具体返回错误码请参考错误码说明
{ "error_msg" : "Stream is not activated successfully, please retry. Can not get endpoint.", "error_code" : "VIS.0204"
}
状态码
状态码 描述
200 请求响应成功
400 请求错误。具体返回错误码请参考错误码说明
6 设备管理
创建GB/T28181设备通道 获取设备列表
更新GB/T28181设备通道信息 获取NVR设备通道列表 删除GB/T28181设备 更新NVR设备通道列表
更新GB/T28181设备通道接入策略