描述
获取按回放分辨率下载地址
接口地址
http://e.vhall.com/api/v1/record/download
请求参数
参数名 | 类型 | 必选 | 说明 |
---|---|---|---|
record_id | int | 是 | 回放id |
quality | string | 是 | 分辨率(例如:360p) |
callback_url | sring | 否 | 回调地址 |
注:非必传字段可以不传,但是不可以传空
接口中必须包含公共请求参数。关于公共请求参数详细内容,请参考 公共请求参数。 **说明:**生成回放视频需要转码操作,可能时间比较长,回放视频时间越长,转码需要时间越长,所以需要传callback_url,生成成功之后会将下载地址异步回调到callback_url,视频保存时间为7天,如果此回放生成过视频文件,并且未过期,则会直接返回下载地址 回调会回传两个参数如下: { "record_id":"108071", //回放id 'quality' : '清晰度', //清晰度 "download_url":"http://t-ds.vhallyun.com/vhallda0220200827165116.zip" //回放下载地址 }
响应示例
{
"code": 200,
"msg": "操作成功!",
"data": {
"record_id":"108071",
"download_url": '', *//回放下载地址,如生成过的会直接返回下载地址,否则此字段返回空,通过异步回调callback_url回传下载地址*
}
}
错误码
code | 含义 | |
---|---|---|
200 | 操作成功! | |
201 | 系统错误,请稍后重试! | |
202 | 参数异常! | |
211 | 不能获取非本账号的活动信息 | |
212 | 回放数据为空 | |
213 | 未发现回放数据,请检查传入的回放ID | |
214 | 活动类型错误,不支持Flash活动 | |
215 | 分辨率错误,目前只支持 a,360p,480p,7 | 20p,same |
216 | 回调地址格式错误 | |
217 | 操作失败,请稍后重试! | |
218 | 当前分辨率正在转换,请误重复操作!' | |
221 | 当前分辨率已经转换,请误重复操作! |