# 观影时长开始记录接口
# 简介
# 业务介绍
合作方传入用户手机号开始记录观影时长
# 交互方式
接口采用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 | 自行设定 |
点击此处进行接口调试
← 点播券查询接口 查询用户会员等级接口 →