获取客户的积分信息
最后更新:2023/04/06企业可通过此接口获取客户的积分信息
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/integral/customer/page?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数
{
"customer_ids" : ["fake_data"],
"customer_id_type" : 1,
"current_index" : 1,
"page_size" : 10
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
customer_ids | string[] | 否 | 客户ID(最多支持传入100个,不传默认查全部) |
customer_id_type | int | 否 | 客户id类型(不传默认查询企业主体/自建应用external_userid) 1:服务商主体/三方应用external_userid 2:企业主体/自建应用external_userid 3:服务商主体/三方应用unionid 4:企业主体/自建应用unionid 5:客户积分用户id |
current_index | int | 否 | 页码。默认值为1 |
page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 1,
"records": [
{
"customer_id": "wovvCXcABCrlLF8_1MGJgXN3qEXnzV5g",
"balance_integral": 5,
"total_integral": 5,
"consume_integral": 0,
"expire_integral": 0,
"total_add_integral_days": 0,
"continuous_add_integral_days": 0
}
]
}
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | object | |
total | long | |
records | object[] | |
customer_id | string | 客户id |
balance_integral | long | 积分余额 |
total_integral | long | 已发放积分 |
consume_integral | long | 已消耗积分 |
expire_integral | long | 已过期积分 |
total_add_integral_days | long | 累计积分天数 |
continuous_add_integral_days | long | 连续积分天数 |