# 积分查询接口
# 简介
# 业务介绍
积分查询
# 接口域名
| 环境 | 域名 | 
|---|---|
| 生产 | 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 | 签名错误 | 
点击此处进行接口调试
  ← 退单回调接口 解锁状态批量查询接口 →
