## 获取用户积分记录列表(myIntegralList) >[info] 场景说明:获取用户的积分消费(获得)记录 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/my/integral/list ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | type | string | 可选 | 积分记录类型,"income"=收入的积分、"pay"=支出的记录、"frozen"=冻结的积分。如果是查询收入或支出的记录,则必须状态是完成的记录才会返回数据 | | page | integer | 可选 | 当前页 | | page\_size | integer | 可选 | 每页读取多少条记录,默认10条 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "type": "income" } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 积分记录列表 | | └ pagination | array | 必须 | 分页信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | log\_id | integer | 必须 | 记录ID | | userid | integer | 必须 | 用户ID | | order\_id | integer | 可选 | 关联的订单ID | | order\_sn | string | 可选 | 关联的订单编号 | | changes | decimal | 必须 | 积分变化金额,如果是积分消费,则为负值 | | balance | decimal | 必须 | 当时积分余额 | | name | string | 必须 | 标题 | | flag | string | 可选 | 备注 | | state | string | 必须 | 记录状态,取值:"finished"=完成、"frozen"=冻结、"cancel"=取消(关闭) | | add\_time | string | 必须 | 添加时间,格式:yyyy-mm-dd hh:ii:ss | 返回`data->pagination`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | integer | 必须 | 当前页 | | page\_size | integer | 必须 | 每一页显示的数据量 | | page\_count | integer | 必须 | 总页数 | | total | integer | 必须 | 总记录数 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "log_id": 2, "userid": 3, "changes": 10, "order_id": 0, "order_sn": "", "balance": 100.00, "name": "签到积分", "flag": "签到获得10积分", "state": "finished", "add_time": "2020-8-9 12:34:49" }, { "log_id": 1, "userid": 3, "changes": -10, "order_id": 3, "order_sn": "15090988767847", "balance": 90.00, "name": "抵扣积分", "flag": "", "state": "frozen", "add_time": "2020-8-8 14:34:29" } ], "pagination": { "page":1, "page_size":10, "page_count":1, "total":1 } } } ```