使用场景:

当积分主体配置为“外部积分系统”时,查询企业维度的积分总额信息时,积分集成服务会请求积分类型自建应用中所配置的接口地址。

场景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
  }
}
```