视频上传接口（已集成在 SDK 中）-成都狮龙书廊科技有限责任公司长春分公司

新闻搜索

新闻动态

视频上传接口（已集成在 SDK 中）

成都狮龙书廊科技有限责任公司长春分公司 2016-05-16 01:56:47 文字：【大】【中】【小】

摘要：视频上传接口（已集成在 SDK 中）

视频上传接口（已集成在 SDK 中）

请求上传

上传之前先要请求一个 file_id。

1.1.1 web 端请求上传

请求地址：GET http://upload.iqiyi.com/openupload 注:这是正式的 api 请求地址
请求参数:

参数名	类型	是否必须	描述
filetype	string	是	上传文件的类型，如: mp4,avi 之类
filesize	string	是	上传文件的 size
access_token	string	是	开放平台分配的 access token，OAuth 授权后获得

说明:access_token,filetype,filesize通过http的header传递。
请求返回json字符串:
{"code": "A00000", "data": {"upload_url": "http://220.181.184.157/upload", "file_id": "4004551398f84a38a371e107f099d27e"}}
# code说明：
# "A00000"：成功
# "A00005"：应用待审核
# "A00007"：应用审核未通过
# "A00008"：应用被冻结
# "A00009"：应用被删除
# "A00010": 输入参数错误
# "A00018"：超过应用的最大配额
# data中的file_id用于后续上传标识文件
# data中的upload_url作为后续上传文件时POST的地址

1.2 上传

分片上传，支持断点续传和大文件。
请求地址:POST http://qichuan.iqiyi.com/upload
注：请求的 url 为：申请 fileid 时候，接口返回的 upload_url 参数值。
请求参数:

参数名	类型	是否必须	描述
file_size	string	是	文件的总大小
range	string	是	写文件的范围,range 需要在文件总大小的有效范围内, 注意 range 下标从 0 开始,比如一个文件大小为1024字节，上传的时候可以分片上传，第一片0-512，第二片513-1023；如果不分片则是0-1023。
file_id	string	是	上传之前获取到的file_id
file	char[]	是	上传片段的内容

注:file_id,file_size, range通过http的header传递,file通过post表单传递。
请求返回:
{"code": "A00000", "range_md5": "6f81e24140e8a84e176ebf02eece3e56", "file_range_accepted": 25, "file_id": "029309c868ea4f4eb188630e9bd94eee"}
# code说明：
# "A00000"：成功
# "A00005": 非法的 file_id
# "A00010": 输入参数错误
body参数支持
(1) 指定Http query string为type=body，此时boundary必须是约定好的"==iqiyiqcboundary", body采Httpmultipart/form-data封装。
请求：
POST http://qichuan.iqiyi.com/upload?type=body

参数同header部分，放到body里即可.
(2) 未指定Http query string中的type=body，此时boundary无需指定，服务端自检测，body采用Http multipart/form-data封装。
请求：
POST http://qichuan.iqiyi.com/upload

参数同header部分，放到body里即可.
请注意，file参数必须放到最后而且必须指定filename非空，例如filename=file

1.3 通知上传完成

请求地址:
POST http://upload.iqiyi.com/uploadfinish 注:这是正式的api请求地址。如果需要在测试环境调试，再给出测试环境的请求url。
请求参数:

参数	类型	是否必须	描述
range_finished	string	是	值是"true"表示传完
access_token	string	是	开放平台分配的 access token，OAuth 授权后获得
file_id	string	是	文件的id

注:参数全部通过header传递。
请求返回:
{"code": "A00000"}
# code说明：
# "A00000": 成功
body参数支持
(1) 指定Http query string为type=body，此时boundary必须是约定好的"==iqiyiqcboundary", body采Httpmultipart/form-data封装。
请求：
POST http://qichuan.iqiyi.com/upload?type=body
参数同header部分，放到body里即可.
(2) 未指定Http query string中的type=body，此时boundary无需指定，服务端自检测，body采用Http multipart/form-data封装。
请求：
POST http://qichuan.iqiyi.com/upload
参数同header部分，放到body里即可.

1.4 取消上传

请求地址:
POST http://upload.iqiyi.com/cancelupload 注:这是正式的api请求地址。如果需要在测试环境调试，再给出测试环境的请求url。
请求参数:

参数	类型	是否必须	描述
status	int	是	2 表示停止
access_token	string	是	开放平台分配的 access token，OAuth 授权后获得
file_id	string	是	文件的id

注:参数全部通过header传递。
请求返回:
#成功时返回
{"code": "A00000"}
# code说明：
# "A00000": 成功
body参数支持
(1) 指定Http query string为type=body，此时boundary必须是约定好的"==iqiyiqcboundary", body采用Http multipart/form-data封装。
请求：
POST http://qichuan.iqiyi.com/cancelupload?type=body
参数同header部分，放到body里即可.
(2) 未指定Http query string中的type=body，此时boundary无需指定，服务端自检测，body采用Http multipart/form-data封装。
请求：
POST http://qichuan.iqiyi.com/cancelupload
参数同header部分，放到body里即可.

1.5 上传文件 meta 信息接口

接口名称
上传文件 meta 信息接口
接口地址(RESTFUL)
http://openapi.iqiyi.com/api/file/info?access_token=ACCESS_TOKEN&file _id=FILE_ID&file_name=FILE_NAME&description=DESC
HTTP 方法
GET
参数	必须	说明
access_token	true	开放平台分配的access token，OAuth授权后获得
file_id	true	文件上传id
file_name	true	文件名称
description	true	文件描述
tags	false	用户自定义标签，如"青春、搞笑"等等【以半角逗号分隔】
file_type	false	分类 '1' => '电影', '2' => '电视剧', '3' => '纪录片', '4' => '动漫', '5' => '音乐', '6' => '综艺', '7' => '娱乐', '8' => '游戏', '9' => '旅游', '10' => '片花', '12' => '教育', '13' => '时尚', '15' => '少儿', '16' => '微电影', '17' => '体育', '20' => '广告', '21' => '生活', '22' => '搞笑', '24' => '财经', '25' => '资讯', '26' => '汽车', '27' => '原创', '28' => '军事',
返回结果
{ ‘code ’: A00000, ‘msg’: ‘’ }
状态码
A00000	成功
Q00001	失败

2. 授权

接口名称
隐式请求accesstoken
接口地址(RESTFUL)
https://openapi.iqiyi.com/api/iqiyi/authorize?client_id=APP_KEY&client_secret=APP_SECRET
HTTP 方法
GET
参数	必须	说明
client_id	true	申请应用时分配的app_key
client_secret	true	申请应用时分配的app_secret
返回结果
{ ‘code ’: A0000, ‘data ’: { ‘access_token ’: ACCESS_TOKEN, // 访问令牌 ‘expires_in’ : 60, // 过期时间 ‘refresh_token’: REFRESH_TOKEN, // 刷新令牌 } }
状态码
A00000	成功
Q00001	失败
A00007	系统错误
A21324	client_id或client_secret参数无效

3. 刷新access_token

接口名称
用于请求accesstoken
接口地址(RESTFUL)
https://openapi.iqiyi.com/api/oauth2/token?client_id=APP_KEY&grant_type=refresh_token&refresh_token=REFRESH_TOKEN
HTTP 方法
GET
参数	必须	说明
client_id	true	申请应用时分配的app_key
grant_type	true	返回refresh_token
refresh_token	true	刷新令牌refresh_token
返回值(JSON)
{ ‘access_token ’=> ACCESS_TOKEN, // 访问令牌 ‘expires_in’=>60, // 过期时间 ‘refresh_token’=> REFRESH_TOKEN, // 刷新令牌 }
返回值
access_token	开放平台分配的 access token，OAuth 授权后获得
expires_in	accesstoken过期时间，以返回的时间的准，单位为秒，注意过期时提醒用户重新授权
refresh_token	刷新token

4. 获取视频状态

接口名称
获取个人上传视频状态信息
接口地址(RESTFUL)
http://openapi.iqiyi.com/api/file/fullStatus?access_token=ACCESS_TOKEN&file_id=FILE_ID
HTTP 方法
GET
参数	必须	说明
access_token	true	开放平台分配的access token，OAuth授权后获得
file_id	true	文件的id
返回结果
{ ‘code ’: A00000, ‘data ’: { ‘img’: ‘http://pic8.qiyipic.com/thumb/20130427/v493238.jpg’, ‘thumbnail’: ‘http://pic8.qiyipic.com/thumb/20130426/v492138.jpg’, ‘swfurl’: ‘http://dispatcher.video.qiyi.com/disp/shareplayer.swf?vid=fbdf63138b0d4dbf9aa6815076ab4c5c&tvId265097&cnId=23&coop=coop_videolianbo&cid=&bd=1&autoChainPlay=0&autoplay=1’, ‘urllist’: { "mp4": { "2":"http://data.video.qiyi.com/videos/trailers/20120903/c9dbb5c569c6fc541d70f9f334b546dd.mp4", "1":"http://data.video.qiyi.com/videos/trailers/20120903/4d932b60c97742e61c45951ac3152e09.mp4" }, "m3u8": { "3":"http://meta.video.qiyi.com/41/2ac2f8d171360e4d4c34bbf0d9615ec0.m3u8", "2":"http://meta.video.qiyi.com/39/c6961db04ed5dbca8acfc8bb9645b028.m3u8", "96":"http://meta.video.qiyi.com/42/6cfecdaaf63d8c47df7ba27daf47b145.m3u8", "1":"http://meta.video.qiyi.com/40/3b57cd6d804b8db0fb0a4ecdb80c39c0.m3u8" } }, }, ‘msg ’: ‘’, } 注意： Urllist中mp4/m3u8代表不同的视频类型， 1表示流畅 2表示高清 96表示极速
状态码
A00000	视频处理完成
Q00001	失败
A00001	视频发布中
A00002	视频审核失败
A00003	视频不存在
A00004	视频上传中
A00006	用户取消上传
A00007	视频发布失败

举例：
https://openapi.iqiyi.com/api/file/fullStatus?access_token=fc20472082db cc21d856678b358d5f0f&file_id=3aa3c62db3714f27b99b8ac0ccc6a864

5. 获取视频信息

接口名称
获取上传视频列表信息说明：该接口只返回转码完成，并且审核通过，或者先发候审的视频列表信息
接口地址(RESTFUL)
http://openapi.iqiyi.com/api/file/videoListForExternal?access_token=ACCESS_TOKEN&file_ids=FILE_ID1,FILE_ID2&page_size=20&page=1
HTTP 方法
GET
参数	必须	说明
access_token	true	开放平台分配的access token，OAuth授权后获得
file_ids	true	文件的id，多个 file_id 以“,” 隔开 file_ids为空或者不传，获取用户所有的视频信息
page_size	false	每页大小,默认 20，最大100
page	false	第几页,默认第一页
返回结果
{ ‘code ’: A00000, ‘count ’: 20, // 用户视频总数 ‘data ’: [ { "fileId": "903875148f0c420481ec09f757b23599", "fileName": "meipai001", "createTime": 1364191124, "description": "百度美拍上传的第一个视频", "fileSize": 0, // 视频大小bytes "fileStatus": 2, // 视频状态 "playCount": 24, // 播放次数 " duration": 10, // 视频时长(s) " img": " http://pic7.qiyipic.com/thumb/20130426/v492995.jpg ", " originalImg": "http://img5.qiyipic.com/image/openapi/openapi_4901611c0c588501efe9b0fed050f1ed_352x256.jpg" " thumbnail": " ", " pageUrl": "http://www.iqiyi.com/common/qplay.html?cnid=23&tvid=537215&vid=757a1261647f4319ab89d2b39f4073e9 " }, (省略……) ] } fileStaus字段说明 1: // 发布中 2: // 已经发布 3: // 审核未通过 4: // 视频不存在/已删除 5: // 上传中 6: // 客户取消上传
状态码
A00000	成功
Q00001	失败
A21332	AccessToken无效
A21327	AccessToken过期

举例：
https://openapi.iqiyi.com/api/file/videoListForExternal?access_token=fc 20472082dbcc21d856678b358d5f0f&file_ids=9c3d3848c8c44e7598655026cf5f96b a,37f864e49dc44ad2958f52e89b41b67d&page_size=10&page=1
https://openapi.iqiyi.com/api/file/videoListForExternal?access_token=fc 20472082dbcc21d856678b358d5f0f&page_size=10&page=1

6. 获取视频 URL 列表

接口名称
用于获取视频多格式url播放列表
接口地址(RESTFUL)
http://openapi.iqiyi.com/api/file/urllist?access_token=ACCESS_TOKEN&file_id=FILE_ID
HTTP 方法
GET
参数	必须	说明
access_token	true	开放平台分配的access token，OAuth授权后获得
file_id	true	文件上传id
返回值(JSON)
{ "code": "A00000" "data": { "mp4": { "1": "http://data.video.qiyi.com/videos/v/20130801/4de7081efdf13d45c0a1c877288cb408.mp4?v=933670055", "2": "http://data.video.qiyi.com/videos/v/20130801/9133baee1511799aee15aa1b91ed9fb7.mp4?v=933670055" }, "m3u8": { "1": "http://meta.video.qiyi.com/20130801/64f89327ce7ef309fdfadfcf7bb971bf.m3u8", "96": "http://meta.video.qiyi.com/20130801/d0eed6e3a09447c6468677ed6afa6ed3.m3u8" } }, } // 视频格式 pc以及移动端m3u8: 96-->极速 1 --> 流畅 2 --> 高清 3 --> 超清 4 --> 720P 5 --> 1080P 移动端mp4: 1 --> 流畅 (200K） 2 --> 高清（400K）
返回值
access_token	开放平台分配的 access token，OAuth 授权后获得
expires_in	accesstoken过期时间，以返回的时间的准，单位为秒，注意过期时提醒用户重新授权
refresh_token	刷新token

注：
1、接口返回的mp4和m3u8地址，都需要带IP二次换取播放地址。
2、 mp4和m3u8地址都是有有效期的，一般15分钟，建议是每次播放前都重新调用接口获取地址。

7. 删除视频信息

接口名称
删除个人上传视频
接口地址(RESTFUL)
https://openapi.iqiyi.com/api/file/delete?access_token=ACCESS_TOKEN&d elete_type=1&file_ids=FILE_ID1,FILE_ID2
HTTP 方法
GET
参数	必须	说明
access_token	true	开放平台分配的access token，OAuth授权后获得
delete_type	true	0表示删除全部，1表示删除file_ids的id
file_ids	true	文件的id，多个 file_id 以“,” 隔开
返回结果
{ ‘code ’: A00000, }
状态码
A00000	成功
Q00001	失败

浏览 (104) | 评论 (0) | 评分(0) | 支持(0) | 反对(0) | 发布人：毛凌国.中国

将本文加入收藏夹

新闻动态

企业新闻行业动态产品知识友情链接网站开发人物分享

请输入内容<--狮龙书廊跑马灯文件代码区->

感谢您注册参加技术达人“秀”—“数字化变革新旗舰5K智能协作终端发布”在线研讨会。

	活动日期：2017年6月8日
	北京时间：上午10:00-11:00
	活动号：204 914 711
	活动密码：170608

网站编辑@ 2017 年成都狮龙书廊科技有限责任公司。
Cisco、Cisco Systems和Cisco Systems标志是思科系统有限公司和/或其子公司在中国和特定国家和地区的商标或注册商标。
本文中涉及的所有其它商标均属于各自所有者的资产。

请输入内容

欢迎参加第五届豆瓣阅读征文大赛

详情

豆瓣阅读　　发送至 public　　

隐藏

发件人：豆瓣阅读　　

收件人：

public　　

抄　送：

密　送：

时　间：2017-08-11 15:28

时　间：

地　点：

邮件已加密，收件方查看邮件需要密码。邮件已加密，密码：

回复
转发

查看译文

查看原文

对照显示

正在翻译，请稍候...

第五届豆瓣阅读征文大赛自 7 月 14 日开放投稿，征稿期已经过半，欢迎感兴趣的你继续来参加。已经创建草稿的作者们，也请记得在截稿之前完成提交。
本届大赛围绕「女性」「悬疑」「科幻」「奇幻」「文艺」五个小说类型，设有「新女性故事：职业」「新女性故事：单身状态」「生活悬疑」「科幻故事」「城市奇幻」「文艺小说」六个组别。每组各设：首奖 1 名，奖金 2 万元；优秀奖 3 名，奖金各 1 万元。另设多项特别奖和合作方奖项，奖金各 1 万元。这是豆瓣阅读迄今以来，主题最多样、奖项最丰富的一次征文大赛。
本届大赛截稿时间为 2017 年 9 月 4 日 23:59，请访问 https://read.douban.com/competition/2017/ 进行投稿（提交作品请在电脑网页端操作）。投稿时需选择其中一组，不可同时参加。每位参赛者仅限提交 1 部作品，提交之后不可修改或更换作品。参赛作品字数在 2 万字至 5 万字，以简体中文写作，体裁为小说。参赛作品必须未曾公开发表过，未曾获得任何奖项。
征稿期还剩三周，请抓紧时间完成你的参赛作品吧！
投稿点这里： https://read.douban.com/competition/2017/
豆瓣阅读

美橙视频制作中心

独特创意精妙制作品质铸造超高性价比

专业实景影棚

1000平方米实景影棚

超2000平方米外拍基地

一流的影视设备

电影级摄像机、灯光设备、

专业航拍机等

资深制作团队

资深编导、策划、拍摄、

后期制作专业操刀

专业配音

80多位资深配音，支持

普通话、英文、方言等

免费创意提案

免费策划创意，创作文案及

分镜头脚本

项目修改满意为止

影片无理由、无限制修改，

直至满意

8月优惠超给力，一降到底，品质不打折，匠心制作！

企业宣传片	片长：60秒
专业配音\|文案修饰\|片头LOGO设计\|画面制作\|精修剪辑、配乐、调色、特效，后期制作

原价4600元

特惠：2300元

企业宣传片(尊享版)	片长：60秒
专业配音\|文案修饰\|片头LOGO设计\|视频与画面混编制作\|精修剪辑、配乐、调色，特效，后期制作

原价5600元

特惠：2800元

产品形象宣传片	片长：60秒-90秒
产品360度外观，真实专业拍摄\|创意策划、音乐、特效、调色、后期制作

原价6400元

特惠：3200元

产品介绍宣传片	片长：60秒-90秒
产品360度外观，真实专业拍摄\|产品操作演示场景（含模特或主持人）画面拍摄\|创意策划、音乐、特效、调色、后期制作

原价8600元

特惠：4800元