# 积分查询接口
# 简介
# 业务介绍
积分查询
# 接口域名
环境 | 域名 |
---|---|
生产 | openapi.vip.iqiyi.com |
测试 | test-openapi.vip.iqiyi.com |
# URL
/partner/points/queryPresentPoints
# 请求方式
参数 | 说明 |
---|---|
Method | GET/POST |
Content-Type | application/x-www-form-urlencoded |
# 请求参数
参数 | 名称 | 类型 | 是否必须 | 说明 | ||
---|---|---|---|---|---|---|
partnerNo | 合作方编码 | String | 是 | |||
userId | 合作方用户唯一标识 | String | 否 | 此项和mobile均非必填,如果两项都传,以userId为准 | ||
mobile | 手机号 | String | 否 | |||
items | 产品信息 | JsonString,json格式的字符串 | 是 | 例如:[{"productCode":"xxxx","amount":1}] | ||
productCode | 产品编码 | String | 是 | |||
amount | 数量 | Integer | 否 | 默认为:1 | ||
sign | 接口签名 | String | 是 | 调用签名,签名算法参见:https://developer.vip.iqiyi.com/custom/TOB/subscribeTob.html#MD5 |
# 返回参数
参数 | 名称 | 类型 | 说明 | ||
---|---|---|---|---|---|
code | 状态编码 | String | A00000,成功 Q00301,参数错误 | ||
msg | 状态编码说明 | String | |||
data | 数据体 | List | |||
partnerNo | 合作方编码 | String | |||
productCode | 产品编码 | String | |||
obtainPoints | 获得积分 | Integer | obtainPoints = (extraPoints + skuPoints):获得积分,如果非积分商品返回0 | ||
extraPoints | 额外获得积分 | Integer | |||
skuPoints | 商品可获得积分 | Integer |
# 返回示例
{
"code": "A00000",
"message": "成功",
"msg": "成功",
"data": [
{
"productCode": "XXXX",
"partnerNo": "XXXX",
"points": 720
}
]
}
# 返回码定义
返回码code | 描述 | 备注 |
---|---|---|
A00000 | 成功 | |
Q00301 | 参数错误(如合作方编号为空,合作方用户为空,参数错误_合作方产品无效等) | |
Q00307 | 签名错误 |
点击此处进行接口调试
← 退单回调接口 解锁状态批量查询接口 →