Commit cf67deb2947f5acbe8fd3a6614a887d68d405679
1 parent
be617e50
添加点播转码接口
Showing
1 changed file
with
98 additions
and
0 deletions
01.点播云/3.2 点播转码接口.md
0 → 100644
| 1 | +### 点播视频转码URL接口 | ||
| 2 | +----- | ||
| 3 | +#### URL: http://transcode.cnlive.com/api/request | ||
| 4 | +----- | ||
| 5 | +#### 接口说明: 针对视讯云平台上传内容的转码服务 | ||
| 6 | +----- | ||
| 7 | +#### 请求方式: HTTP POST | ||
| 8 | +----- | ||
| 9 | +#### 返回格式: JSON | ||
| 10 | +----- | ||
| 11 | +#### 请求参数说明: | ||
| 12 | +| 参数名 | 参数类型 | 必选 | 参数说明 | | ||
| 13 | +| :----------- | :------: | :------: | :------: | | ||
| 14 | +| appId | string | true | 应用ID | | ||
| 15 | +| params| json | true | 请求json数据 | | ||
| 16 | + | ||
| 17 | +----- | ||
| 18 | + | ||
| 19 | +#### params参数说明: | ||
| 20 | +| 参数名 | 参数类型 | 必选 | 参数说明 | | ||
| 21 | +| :----------- | :------: | :------: | :------: | | ||
| 22 | +| plat | int | false | 转码平台,根据当前业务所应用的存储平台对应, 0:金山;1:七牛 默认为0| | ||
| 23 | +| path| string | true | 源文件的相对路径 格式：/{bucket}/{object_name} | | ||
| 24 | +| dstBucket| string | false | 转码存储bucket,默认同源视频同bucket | | ||
| 25 | +| dstDir| string | true | 输出文件key的路径、不允许以/开头 注:type=avsample 时 系统会在最后面加一级目录 目录名长度32位。| | ||
| 26 | +| type| string | true | 转码类型，针对该视频转码固定取值,type:avop| | ||
| 27 | +| rates| string | false | 码率集合、单位K，多个码率以逗号分隔。根据该参数返回指定的码率视频信息。取值范围:(流畅:400;标清:800;高清:1500;超清:3000)| | ||
| 28 | +| attach| json | false | type相关附带参数 非必填 格式:json| | ||
| 29 | +| cbUrl| string | true | 回调用户地址,回调请求采用post body形式| | ||
| 30 | +| extParam| json | false | 附加参数 json| | ||
| 31 | + | ||
| 32 | +----- | ||
| 33 | + | ||
| 34 | +#### attach(转码加水印任务必填)参数说明: | ||
| 35 | + | ||
| 36 | +| 参数名 | 参数类型 | 必选 | 参数说明 | | ||
| 37 | +| :----------- | :------: | :------: | :------: | | ||
| 38 | +| path | string | true | logo源文件的相对路径 格式：/{bucket}/{object_name}| | ||
| 39 | +| position | int | false | 水印方位 默认值：0 取值范围:左上角:0;右上角:1;左下角:2;右下角:3;| | ||
| 40 | + | ||
| 41 | +----- | ||
| 42 | + | ||
| 43 | +#### attach(转码加水印任务必填)参数说明: | ||
| 44 | + | ||
| 45 | +| 参数名 | 参数类型 | 必选 | 参数说明 | | ||
| 46 | +| :----------- | :------: | :------: | :------: | | ||
| 47 | +| domain | string | false | 音视频源文件外链域名，plat=1时必填| | ||
| 48 | +| avconcat | string | false | 添加片头、片尾，json字符串| | ||
| 49 | +| startTime | string | false | 音视频剪辑开始时间点，不填即不计入剪辑范围。格式 HH:mm:ss(目前仅支持plat=0)| | ||
| 50 | +| endTime | string | false | 音视频剪辑结束时间点，不填即不计入剪辑范围 格式 HH:mm:ss(目前仅支持plat=0)| | ||
| 51 | + | ||
| 52 | +----- | ||
| 53 | +#### avconcat 参数说明: | ||
| 54 | +| 参数名 | 参数类型 | 必选 | 参数说明 | | ||
| 55 | +| :----------- | :------: | :------: | :------: | | ||
| 56 | +| headFile | string | false | 片头 格式:/{bucket}/{object_name}| | ||
| 57 | +| endFile | string | false | 片尾 格式:/{bucket}/{object_name}| | ||
| 58 | + | ||
| 59 | +----- | ||
| 60 | + | ||
| 61 | +#### 请求示例: | ||
| 62 | +``` | ||
| 63 | +{ | ||
| 64 | + "appId":"82_XXX", | ||
| 65 | + "params":{ | ||
| 66 | + "cbUrl":"http://test.transcode.cnlive.com/ts/defaultNotify", | ||
| 67 | + "path":"/trans-test/60/1465695/vod/2017/0323/60_527f266385614dd48ad5a0932ffca16a.mp4", | ||
| 68 | + "cbMethod":"POST", | ||
| 69 | + "formats":"mp4,hls", | ||
| 70 | + "extParam":{ | ||
| 71 | + "startTime":"00:00:00", | ||
| 72 | + "endTime":"10:00:10" | ||
| 73 | + }, | ||
| 74 | + "dstDir":"60/1465695/vod/2017/0323", | ||
| 75 | + "rates":"400,800", | ||
| 76 | + "dstBucket":"trans-test", | ||
| 77 | + "attach":{ | ||
| 78 | + "path":"/trans-test/82_20170330173100.png", | ||
| 79 | + "position":0 | ||
| 80 | + }, | ||
| 81 | + "type":"avop" | ||
| 82 | + } | ||
| 83 | +} | ||
| 84 | + | ||
| 85 | + | ||
| 86 | +``` | ||
| 87 | +----- | ||
| 88 | + | ||
| 89 | +#### 请求任务返回数据结构: | ||
| 90 | +``` | ||
| 91 | +{ | ||
| 92 | + code:0, //状态码 0：成功 1：失败 | ||
| 93 | + desc:"success", | ||
| 94 | + taskId:"07e589adf3da4512acaf7864a388e8f6" | ||
| 95 | +} | ||
| 96 | +``` | ||
| 97 | + | ||
| 98 | + | ||
| 0 | \ No newline at end of file | 99 | \ No newline at end of file |