积分系统对接方案

积分系统目前开放了查询用户积分和流水明细的接口，并允许用户使用积分来进行兑换。假如企业用户已经有了一套积分商城系统，那么用户可以在商城系统通过积分兑换礼品。用户兑换礼品后，可以通过金易联开放的积分扣减接口，来扣减对应的积分，达到通过积分兑换礼品的目的；

具体步骤如下：

（1）开发者通过 account 来查询该账号对应的金易联系统的id，接口信息如下： {GET} /api/v1/open/swan/manager/staff/account 获取用户信息，通过该接口可以拿到用户对应的ID；

（2）通过account获取到的id，此时可以通过查询用户总积分的接口查询用户的积分信息，接口信息如下： {GET} /api/v1/open/swan/integral/points 获取用户积分信息；

（3）如果开发者有需求，需要在对应的页面上展示用户最近获取积分明细的展示，可以通过调用查询积分明细的接口，接口信息如下：{GET} /api/v1/open/swan/integral/points/transaction 获取积分明细,该接口根据时间倒排分页；

（4）用户兑换积分：{POST} /api/v1/open/swan/integral/points 通过该接口，可以给用户增加积分，或者扣减积分，假如用户兑换了一个商品需要500 积分，那么通过如下请求，就可以给用户扣减 500积分； 请求Body示例如下：

{
    "transactionId": "7c024e17-52e3-4495-85fa-213a764fda3e",
    "userId": "@staff_staff1:im.finogeeks.com",
    "point": 500,
    "type": "REDUCE",
    "info": "积分兑换商品"
}