# 观影时长开始记录接口
# 简介
# 业务介绍
合作方传入用户手机号开始记录观影时长
# 交互方式
接口采用http或https实现交互,参数以form(application/x-www-form-urlencoded)的方式提交,签名采用SHA256(见附录),最终参数报文中的手机号使用RSA公钥加密投递
# 接口定义
# 应用场景
合作方传入用户手机号开始记录观影时长。
# 接口域名
| 环境 | 域名 |
|---|---|
| 生产 | openapi.vip.iqiyi.com |
| 测试 | test-openapi.vip.iqiyi.com |
# URL
/view-engine/whitelist/add
# 请求方式
| 参数 | 说明 |
|---|---|
| Method | GET/POST |
| Content-Type | application/x-www-form-urlencoded |
# 请求参数
| 变量名 | 名称 | 必填 | 说明 |
|---|---|---|---|
| partnerNo | 合作方编码 | 是 | 合作方的唯一标识,由爱奇艺提供 |
| mobile | RSA加密的手机号 | 是 | 采用RSA 加密后的手机号密文,RSA公钥由爱奇艺侧颁发 |
| sign | SHA256签名 | 是 | 采用SHA256对参数partnerNo和mobile按字母序排序后加上key算的签名 |
# 返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | String | 返回码 |
| msg | String | 返回码说明 |
# 返回示例
JSON格式
{
"code": "A00000",
"msg": "成功"
}
# 返回码说明
| 响应码 | 说明 | 备注 |
|---|---|---|
| A00000 | 请求成功 | |
| Q00301 | 参数错误,如orderNo不存在、产品内容不匹配等 | |
| Q00308 | 请求超时 | 建议重试 |
# 附录
# 签名方法
采用SHA256计算签名,pubkey由爱奇艺提供,具体计算方法如下:
1、 假设共有三个参数 a=3、b=2、c=1;
2、 按参数名的字母正序排列,再用“&”连接后得到串A,即为“a=3&b=2&c=1”;
3、 将pubkey拼接到串A后面,假设pubkey为“qwer”,则拼接后为“a=3&b=2&c=1qwer”;
计算拼接串的SHA256即为最终签名值,注意使用UTF-8编码计算。
# 在线测试
| 参数 | 值 |
|---|---|
| partner | toB_common_test |
| mobile | 自行设定 |
| sign | 自行设定 |
点击此处进行接口调试
← 点播券查询接口 查询用户会员等级接口 →