视频上传接口(已集成在 SDK 中)
请求上传
1.1.1 web 端请求上传
请求参数:
参数名 | 类型 | 是否必须 | 描述 |
filetype | string | 是 | 上传文件的类型,如: mp4,avi 之类 |
filesize | string | 是 | 上传文件的 size |
access_token | string | 是 | 开放平台分配的 access token,OAuth 授权后获得 |
请求返回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[] | 是 | 上传片段的内容 |
请求返回:
{"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 |
请求返回:
{"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 |
请求返回:
#成功时返回
{"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 |
分类 |
返回结果 | ||
{ |
||
状态码 | ||
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 |
返回结果 | ||
{ |
||
状态码 | ||
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,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 |
返回结果 | ||
{ "1":"http://meta.video.qiyi.com/40/3b57cd6d804b8db0fb0a4ecdb80c39c0.m3u8"
} |
||
状态码 | ||
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 | 第几页,默认第一页 |
返回结果 | ||
{ |
||
状态码 | ||
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) | ||
{
// 视频格式 |
||
返回值 | ||
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 以“,” 隔开 |
返回结果 | ||
{ |
||
状态码 | ||
A00000 | 成功 | |
Q00001 | 失败 |
请输入内容
|
![]() |
![]() |
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|