分页查询居民积分流水
更新于 2023-01-18在全员圈或积分管理场景下，可调用本接口分页查询积分流水。查询结果按照ID顺序排列，可查询一段时间内的积分流水记录。
接口说明
你可以通过本接口查询你的积分流水记录，也可以在下图所示页面查看。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 数字区县居民积分读权限 | API Explorer |
| 第三方企业应用 | 支持 | 数字区县居民积分读权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 数字区县居民积分读权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Query参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
isCircle | Boolean | 是 | 是否查询全员圈积分记录，否则查询积分管理积分记录，取值：
|
userId | String | 否 | 用户userid。
说明
如果不传表示查询组织内所有用户的流水数据。 |
nextToken | Long | 是 | 分页游标，第一次请求传0，后续取值是上一次调用此API返回的nextToken参数。 |
maxResults | Integer | 是 | 本次读取的最大数据记录数量，最大值20。 |
startTime | Long | 否 | 起始时间Unix时间戳，单位毫秒。 |
endTime | Long | 否 | 结束时间Unix时间戳（不包含），单位毫秒。 |
返回参数
名称 | 类型 | 描述 |
|---|---|---|
pointRecordList | Array | 积分流水记录列表。 |
userId | String | 用户的userid。 |
score | Integer | 增加或减少的分数。 说明
增加为正数，减少为负数。 |
createAt | Long | 创建时间戳，单位毫秒。 |
uuid | String | 积分记录的唯一幂等标志。 |
ruleCode | String | 对应的行为代码，可以为空。 |
ruleName | String | 对应的行为名字。 |
hasMore | Boolean | 是否还有更多数据。 |
nextToken | Long | 下一次请求的游标起始值。 |
totalCount | Long | 查询的总记录数。 说明
如果为-1则不计算总数。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | orgInvalid.param.error | %s | 组织非百姓通组织 |
400 | checkParameter.param.error | %s | 参数校验失败 |
400 | point.system.error | 积分服务请求失败 %s | 积分服务请求失败 |
500 | sytem.error | system error %s | 系统错误 |
