会员对外文档平台 会员对外文档平台
登录
接口
介绍
  • TOB直充接口

  • TOB激活码直充接口

  • OTT直充接口

  • OTT自动续费接口

  • OTT激活码直充接口

  • 通用接口

  • 内容点播接口

  • 卡券类接口

  • 用户信息接口

    • 观影时长开始记录接口
    • 查询用户会员等级接口
    • 权益查询接口
    • 观影时长查询接口
    • 用户信息解密接口
  • 会员福利接口

  • 合作方客户FV管理

# 观影时长开始记录接口

# 简介

# 业务介绍

合作方传入用户手机号开始记录观影时长

# 交互方式

接口采用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 自行设定
点击此处进行接口调试
在线调试

← 点播券查询接口 查询用户会员等级接口 →