使用场景：
当积分主体配置为“外部积分系统”时，查询企业维度的积分总额信息时，积分集成服务会请求积分类型自建应用中所配置的接口地址。
场景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 |
请求示例
{
"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 |
响应示例
{
"code": "200",
"errorCode": "SUCCESS",
"msg": "ok",
"data": {
"totalPoint": 30,
"validPoint": 20,
"expendPoint": 10,
"expirePoint": 0
}
}