为保护用户数据,小鱼server的录制文件是加密存储的,无法直接播放。若需要进行录制文件的播放分享,可调用该API获取视频的播放地址。
默认接口请求频率限制:20次/秒
REST URL
GET https://sdk.xylink.com/api/rest/external/{version}/vods/{vodId}/sharedInfo?enterpriseId=XXX&signature=XXX
请求参数说明:
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
version | String | Path | 是 | 无 | 传v1即可 | |
enterpriseId | String | Query | 是 | 无 | 企业ID,通过管理平台-云视讯API获得 | |
signature | String | Query | 签名鉴权1.0(旧):是 签名鉴权2.0:否 | 无 | API签名,参考 签名鉴权 | |
vodId | Long | Query | 是 | 无 | 视频id | 3.9 |
linkExpireSec | Long | Query | 是 | 无 | 播放链接过期时间(秒): 最小可设置3600秒; (仅支持mp4格式文件设置) | 5.2 |
请求成功返回结果示例1
{
"playUrl": "http://vod.xylink.com/vodserver-prd-2/cloud/901025680965/101-bj1-prdSig1-1163237707906_0_16423252940831_1280_720.mp4/index.m3u8?proxysessionid=1801309955,bandwidth=1732698",
"innerPlayUrl": "http://vod.xylink.com/vodserver-prd-2/cloud/901025680965/101-bj1-prdSig1-11232967707906_0_1642322940831_1280_720.mp4/index.m3u8?proxysessionid=1808999955,bandwidth=1725698",
"shared": false
}
请求成功返回结果示例2
{
"playUrl": "http://prdvoddownload.xylink.com/vodfiles/downloadfiles/shareLink/697ec9bd-50e4-419c-a28e-3226ge6aba0937.mp4?auth_key=472154227-0-0-7b143b98737e2d60661de4432d64e366c0",
"innerPlayUrl": "http://prdvoddownload.xylink.com/vodfiles/downloadfiles/shareLink/697ec9bd-50e4-419c-a28e-3b66djdj83937.mp4?auth_key=412654227-0-0-7b1322133ae2d60661de42e862366c0",
"shared": true
}
返回参数说明:
参数 | 说明 |
playUrl | 播放链接 注:由于视频地址会失效,故不建议将视频地址缓存、保存本地使用,建议即用即拿。 |
innerPlayUrl | 播放链接: 部署在在内网情况下; 注:由于视频地址会失效,故不建议将视频地址缓存、保存本地使用,建议即用即拿。 |
shared | 是否分享完成: true-分享完成,播放链接为mp4 false-分享未完成,播放链接为m3u8,此时需要等待视频处理完成,直到分享完成 |
请求失败结果示例
{
"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错误码
触发事件回调:首次调用获取视频下载链接或获取视频播放链接,会触发DecryptStatus事件回调。