第三方可以根据录制文件的sessionId来查询录制文件的下载链接
默认接口请求频率限制:20次/秒
链接有效期: 4h
REST URL
GET https://sdk.xylink.com/api/rest/external/{version}/vods/session/{sessionId}/downloadurl?enterpriseId=XXX&signature=XXX
请求参数说明:
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
version | String | Path | 是 | 无 | 传v1即可 | (3.9, 5.2不建议使用该接口) |
enterpriseId | String | Query | 是 | 无 | 企业ID,通过管理平台-云视讯API获得 | |
signature | String | Query | 签名鉴权1.0(旧):是 签名鉴权2.0:否 | 无 | API签名,参考 签名鉴权 | |
sessionId | String | Path | 是 | 无 | 录制sessionId | 3.9 |
请求成功返回结果示例
{
"vodUrlItems": [
{
"innerDownloadUrl": null,
"downloadUrl": "http://prdvoddownload.xylink.com/vodfiles/downloadfiles/2c9ash133as122c4550171aa44101307d0/d/live/9680cec97da4a3383711qs02dab319a03f4c/202112/21111013/adc9ee3e-7332-4c8e-8788-59ea2111wsc.mp4?auth_key=164118013-0-0-8d2fbbb36dsdsdsdsd285cadeb&displayName=21%2D12%2F=D21.mp4",
"ready": true,
"signatureType": 0,
"signatureValue": ""
}
]
}
返回参数说明:
参数名称 | 说明 |
innerDownloadUrl | 内网视频下载地址(混合云部署方式) |
downloadUrl | 外网视频下载链接(通用公有云方式) |
ready | 视频视频处理成功:视频处理成功后放可进行下载 |
signatureType | 摘要加密类型 0:不加密;1:MD5;2:SM3 (default: 0, int类型) |
signatureValue | 文件摘要值 |
fileSize | 录制文件大小 |
请求失败结果示例
{
"developerMessage": "ErrorStatus: SDK_INVALID_APPKEY No app found for extId: ",
"userMessage": "sdk.invalid.key",
"errorCode": 60001,
"moreInfo": "http://www.com.ainemo.com/errors/60001"
}
错误码见小鱼RESTAPI错误码