添加点播转码接口 (cf67deb2) | Commits | OPEN-API / WIKI

Browse Code »

Commit cf67deb2947f5acbe8fd3a6614a887d68d405679

Authored by 范晓春 2018-01-04 11:09:42 +0800

1 parent be617e50

添加点播转码接口

Inline Side-by-side

Showing 1 changed file with 98 additions and 0 deletions

01.点播云/3.2 点播转码接口.md 0 → 100644

View file @cf67deb

	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	99	\ No newline at end of file
...	...

OPEN-API / WIKI · Commits

GitLab

添加点播转码接口