# 观影时长查询接口
# 简介
# 业务介绍
适用于合作方查询某个用户的观影时长数据。
# 交互方式
接口采用http实现交互，参数以form（application/x-www-form-urlencoded）的方式提交，暂不支持JSON、XML格式的参数，数据采用MD5方式加密
# 接口定义
# 应用场景
通过此接口查询特定用户的观影时长。目前不支持按天维度查询，只支持查询从“加入白名单开始记录”时到当前时间段的观影时长。
# 接口域名
| 环境 | 域名 |
|---|---|
| 生产 | openapi.vip.iqiyi.com |
| 测试 | test-openapi.vip.iqiyi.com |
# URL
/view-engine/viewtime/act
# 请求方式
| 参数 | 说明 |
|---|---|
| Method | GET/POST |
| Content-Type | application/x-www-form-urlencoded |
# 请求参数
| 变量名 | 名称 | 是否必须 | 说明 |
|---|---|---|---|
| partnerNo | 合作方编码 | 是 | 合作方的唯一标识 |
| mobile | RSA加密的手机号 | 是 | 采用RSA 加密后的手机号密文，RSA公钥由爱奇艺侧颁发 |
| sign | 签名串 | 是 | SHA256签名 |
# 返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | String | 返回码，参考附录 |
| msg | String | 返回码说明 |
| time | Long | 观影时长，单位秒 |
# 返回示例
返回值格式：（time的单位是秒）
{
"code": "A00000",
"msg": "成功",
"data":
{
"time": 3600
}
}
# 返回码说明
| 响应码 | 说明 | 备注 |
|---|---|---|
| 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 | 自行设定 |
点击此处进行接口调试