当积分主体配置为“外部积分系统”时,查询企业维度的积分总额信息时,积分集成服务会请求积分类型自建应用中所配置的接口地址。
场景1:工作台 - 权益 - 积分管理 - 积分明细(累计发放积分、累计可用积分、累计过期积分、累计消耗积分)
**接口地址** `自建应用配置` **请求方式** `POST` **consumes** `["application/json"]` **produces** `["application/json"]` **接口描述** `企业级接口,hearer必须携带X-Token` **应用权限** `积分 -> 外部积分-总额查询-企业维度` **注意事项** # 请求参数 *** ### 请求头参数 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | X-Token | 自建应用访问token | header | true | string | | ### 公共参数 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | instanceAppId| 自建应用appid | string | true | String | | | thirdCompanyId| 开放平台登陆componyId | string | 非开放平台用户为空 | String | | | orgId| 企业id | string | true | String | | ### 请求示例 ```json { "appInstanceId": 0, "orgId": "d515fa4b-8def-4188-8415-92632581795c", "instanceAppId": "Ipu_t60KoV-gTTtCSkFMWtrkTIA", "thirdCompanyId": "0707", } ``` # 响应参数 *** | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | code | 状态码 | body | true | string | | | errorCode | 异常码 | body | true | string | | | msg | 描述 | body | true | string | | | data | 积分总额信息 | body | true | object | [积分总额信息](#积分总额信息) | ### 积分总额信息 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ----------- | ---------- | -------- | -------- | -------- | ------ | | totalPoint | 累计积分 | body | true | int | | | validPoint | 可用积分 | body | true | int | | | expendPoint | 已消耗积分 | body | true | int | | | expirePoint | 已过期积分 | body | true | int | | ### 响应状态 | 状态码 | 说明 | schema | | ------ | ------ | ------ | | 200 | OK | | | 201 | Created | | | 401 | Unauthorized | | | 403 | Forbidden | | | 404 | Not Found | | ### 响应示例 ```json { "code": "200", "errorCode": "SUCCESS", "msg": "ok", "data": { "totalPoint": 30, "validPoint": 20, "expendPoint": 10, "expirePoint": 0 } } ``` |