1 视频上传接口(已集成在 SDK 中)
1.1 请求上传

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

1.1.1 web 端请求上传

请求地址:GET http://upload.iqiyi.com/openupload 注:这是正式的api请求地址。如果需要在测试环境调试,再给出测试环境的请求url。
请求参数:
参数名类型是否必须描述
filetypestring    是上传文件的类型,如: mp4,avi 之类
filesize string    是上传文件的 size
access_tokenstring    是 开放平台分配的 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_sizestring      是      文件的总大小
rangestring      是      写文件的范围,range 需要在文件总大小的有效范围内, 注意 range 下标从 0 开始,比如一个文件大小为1024字节,上传的时候可以分片上传,第一片0-512,第二片513-1023;如果不分片则是0-1023。
file_idstring      是      上传之前获取到的resource id
filebyte[]      是      上传片段的内容
请求返回:
{"code": "A00000", "range_md5": "6f81e24140e8a84e176ebf02eece3e56", "file_range_accepted": 25, "file_id": "029309c868ea4f4eb188630e9bd94eee"}
# code说明:
# "A00000":成功
# "A00005": 非法的 file_id
# "A00010": 输入参数错误
支持两种形式上传
(1) Content-Type为 multipart/form-data形式
该种情况下,file_size,range,file_id参数可以是header头传递,也可以放在表单中传递,file为需要上传的分片内容
(2) Content-Type为非multipart/form-data形式
此时,file_size,range,file_id必须放在header头中传递,上传请求体中传递分片内容

1.3 通知上传完成

请求地址:
POST http://upload.iqiyi.com/uploadfinish 注:这是正式的api请求地址。如果需要在测试环境调试,再给出测试环境的请求url。
请求参数:
参数类型是否必须描述
file_idstring    是文件的resource id
请求返回:
{"code": "A00000"}
# code说明:
# "A00000": 成功

1.4 取消上传

请求地址:
POST http://upload.iqiyi.com/cancelupload
请求参数:
参数类型是否必须描述
file_idstring    是文件的resource id
请求返回:
#成功时返回
{"code": "A00000"}
# code说明:
# "A00000": 成功

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 失败

北京爱奇艺科技有限公司

公司介绍 新闻动态 联系方式 招聘英才 爱奇艺实验室 开放平台 爱奇艺号认证 爱奇艺号 帮助中心 侵权投诉 About Us

Copyright © 2017 爱奇艺 All Rights Reserved