使用场景:
企业查询用户积分
接口地址 /api/open/audience/point/list
请求方式 GET
consumes ["application/x-www-form-urlencoded"]
produces ["application/json"]
应用权限 无需授权
#请求参数
###请求头参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
X-Token | 自建应用访问token | header | true | string |
###公共参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
nonce | 6位随机字符串 | param | true | string | |
timestamp | unix时间戳(毫秒) | param | true | long |
###用户积分查询条件
- 查询限制 ID集合总长度最大为100
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
audienceUserIds | 用户ID集合 | param | false | Long[] | |
thirdIds | 第三方用户ID集合 | param | false | String[] |
###请求示例
https://
#响应参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
code | 状态码 | body | true | string | |
errorCode | 异常码 | body | true | string | |
msg | 描述 | body | true | string | |
data | 响应数据 | body | true | array | 用户积分 |
###用户积分 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | audienceUserId | 用户ID | body | false | Long | | | thirdId | 第三方用户ID | body | false | String | | | totalPointSum | 总积分 | body | true | int | | | validPointSum | 剩余可用积分 | body | true | int | | | expendPointSum | 已使用积分 | body | true | int | | | expirePointSum | 已过期积分 | body | true | int | | | memberFlag | 是否是会员(0:否, 1:是) | body | true | int | | | memberLevel | 会员等级 | body | true | String | |
###响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
###响应示例
{
"code": "200",
"errorCode": "SUCCESS",
"msg": "ok",
"data": [
]
}