帮你快速理解、总结文档立即下载

获取视频防盗链播放 URL

最近更新时间:2025-12-19 09:17:03
我的收藏

1. 接口描述

接口请求域名: iot.cloud.tencent.com/api/exploreropen/tokenapi
本接口(IotVideoGenerateSignedVideoURL)用于获取视频防盗链播放 URL。

2. 输入参数

名称
类型
必选
描述
Action
String
是
公共参数,本接口取值:IotVideoGenerateSignedVideoURL。
RequestId
String
是
公共参数,唯一请求 ID,可自行生成,推荐使用 uuid。定位问题时,需要提供该次请求的 RequestId。
AccessToken
String
是
公共参数,AccessToken 用于对一个已经登录的用户鉴权。
ProductId
String
是
产品ID。
DeviceName
String
是
设备名称。
VideoURL
String
是
视频播放原始URL地址
ExpireTime
Integer
是
播放链接过期时间

3. 输出参数

名称
类型
描述
RequestId
String
RequestId。
SignedVideoURL
String
视频防盗链播放URL

4. 示例

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"Action": "AppDescribeTemplateBinding",
"AccessToken":"bf******************d098",
"RequestId": "f92406b3-5a9a-4fe8-bc43-45e3d794bb68",
"ProductId": "PRODUCT_ID",
"DeviceName": "DEVICENAME",
"ExpireTime": 1619331648,
"VideoURL": "http://zylcb.iotvideo.tencentcs.com/timeshift/live/1.m3u8"
}
输出示例:成功
{
"Response": {
"SignedVideoURL": "http://zylcb.iotvideo.tencentcs.com/timeshift/live/1.m3u8?sign=x",
"RequestId": "xx"
}
}
输出示例:失败
{
"Response": {
"Error": {
"Code": "InvalidParameterValue.InvalidAccessToken",
"Message": "Token无效"
},
"RequestId": "f92406b3-5a9a-4fe8-bc43-45e3d794bb68"
}
}

5. 错误码

错误码
描述
InvalidParameter
无效参数。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.TokenInfoSaveError
Token 保存失败。