38328 lines
752 KiB
Markdown
38328 lines
752 KiB
Markdown
|
|
# 认证模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**简介**:系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**HOST**:xxxx.xxxx.xxxx
|
|||
|
|
|
|||
|
|
|
|||
|
|
**联系人**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Version**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口路径**:/auth/v2/api-docs
|
|||
|
|
|
|||
|
|
|
|||
|
|
[TOC]
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# app-token-controller
|
|||
|
|
|
|||
|
|
|
|||
|
|
## appLogin
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/appLogin`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"password": "",
|
|||
|
|
"username": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|form|form|body|true|LoginBody|LoginBody|
|
|||
|
|
|  password|||false|string||
|
|||
|
|
|  username|||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## appLogout
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/appLogout`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## appPhoneLogin
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/appPhoneLogin`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": "",
|
|||
|
|
"userPhone": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|form|form|body|true|PhoneLoginBody|PhoneLoginBody|
|
|||
|
|
|  code|手机验证码||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## appRefresh
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/appRefresh`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## register
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/appRegister`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"registerWay": "",
|
|||
|
|
"userImg": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userPwd": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|customerDto|customerDto|body|true|InsertCustomerDto|InsertCustomerDto|
|
|||
|
|
|  registerWay|注册方式{1:用户名 2:手机号}||false|string||
|
|||
|
|
|  userImg|用户头像||false|string||
|
|||
|
|
|  userName|用户名称,暂用手机号||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userPwd|用户密码||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# tenant-token-controller
|
|||
|
|
|
|||
|
|
|
|||
|
|
## login
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/tenant/login`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"password": "",
|
|||
|
|
"username": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|form|form|body|true|LoginBody|LoginBody|
|
|||
|
|
|  password|||false|string||
|
|||
|
|
|  username|||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## logout
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/tenant/logout`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## refresh
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/tenant/refresh`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## register
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/tenant/register`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"password": "",
|
|||
|
|
"username": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|registerBody|registerBody|body|true|RegisterBody|RegisterBody|
|
|||
|
|
|  password|||false|string||
|
|||
|
|
|  username|||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# token-controller
|
|||
|
|
|
|||
|
|
|
|||
|
|
## login
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/login`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"password": "",
|
|||
|
|
"username": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|form|form|body|true|LoginBody|LoginBody|
|
|||
|
|
|  password|||false|string||
|
|||
|
|
|  username|||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## logout
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/logout`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## refresh
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/refresh`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## register
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/auth/register`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"password": "",
|
|||
|
|
"username": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|registerBody|registerBody|body|true|RegisterBody|RegisterBody|
|
|||
|
|
|  password|||false|string||
|
|||
|
|
|  username|||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«object»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||object||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 文件处理模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**简介**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**HOST**:xxxx.xxxx.xxxx
|
|||
|
|
|
|||
|
|
|
|||
|
|
**联系人**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Version**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口路径**:/file/v2/api-docs
|
|||
|
|
|
|||
|
|
|
|||
|
|
[TOC]
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# file-controller
|
|||
|
|
|
|||
|
|
|
|||
|
|
## downLoad
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/file/base/download`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileName|fileName|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 单个文件上传
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/file/base/upload`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`multipart/form-data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|file|file|formData|true|file||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|BaseResponse«FileUploadResp»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||string||
|
|||
|
|
|data||FileUploadResp|FileUploadResp|
|
|||
|
|
|  fileName||string||
|
|||
|
|
|  fileUrl||string||
|
|||
|
|
|  originalFilename||string||
|
|||
|
|
|message||string||
|
|||
|
|
|success||boolean||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": "",
|
|||
|
|
"data": {
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"originalFilename": ""
|
|||
|
|
},
|
|||
|
|
"message": "",
|
|||
|
|
"success": true
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量文件上传
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/file/base/uploadBatch`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|files|files|formData|true|array|file|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|BaseResponse«List«FileUploadResp»»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||string||
|
|||
|
|
|data||array|FileUploadResp|
|
|||
|
|
|  fileName||string||
|
|||
|
|
|  fileUrl||string||
|
|||
|
|
|  originalFilename||string||
|
|||
|
|
|message||string||
|
|||
|
|
|success||boolean||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": "",
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"originalFilename": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"message": "",
|
|||
|
|
"success": true
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# pre-file-controller
|
|||
|
|
|
|||
|
|
|
|||
|
|
## downLoad
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/file/front/base/download`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileName|fileName|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 单个文件上传
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/file/front/base/upload`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`multipart/form-data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|file|file|formData|true|file||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|BaseResponse«FileUploadResp»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||string||
|
|||
|
|
|data||FileUploadResp|FileUploadResp|
|
|||
|
|
|  fileName||string||
|
|||
|
|
|  fileUrl||string||
|
|||
|
|
|  originalFilename||string||
|
|||
|
|
|message||string||
|
|||
|
|
|success||boolean||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": "",
|
|||
|
|
"data": {
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"originalFilename": ""
|
|||
|
|
},
|
|||
|
|
"message": "",
|
|||
|
|
"success": true
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量文件上传
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/file/front/base/uploadBatch`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|files|files|formData|true|array|file|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|BaseResponse«List«FileUploadResp»»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||string||
|
|||
|
|
|data||array|FileUploadResp|
|
|||
|
|
|  fileName||string||
|
|||
|
|
|  fileUrl||string||
|
|||
|
|
|  originalFilename||string||
|
|||
|
|
|message||string||
|
|||
|
|
|success||boolean||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": "",
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"originalFilename": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"message": "",
|
|||
|
|
"success": true
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**简介**:系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**HOST**:xxxx.xxxx.xxxx
|
|||
|
|
|
|||
|
|
|
|||
|
|
**联系人**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Version**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口路径**:/gym/v2/api-docs
|
|||
|
|
|
|||
|
|
|
|||
|
|
[TOC]
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 体育馆VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增体育馆VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/vip`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"backgroundFileList": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"benefitNotice": "",
|
|||
|
|
"businessTypes": "",
|
|||
|
|
"buyNotice": "",
|
|||
|
|
"endNo": 0,
|
|||
|
|
"fieldIds": "",
|
|||
|
|
"isRealAuth": "",
|
|||
|
|
"isSelf": "",
|
|||
|
|
"issueNum": 0,
|
|||
|
|
"logoFileList": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"realAmout": 0,
|
|||
|
|
"realNum": 0,
|
|||
|
|
"salePrice": 0,
|
|||
|
|
"startNo": 0,
|
|||
|
|
"useNotice": "",
|
|||
|
|
"validityTerm": 0,
|
|||
|
|
"venueIds": "",
|
|||
|
|
"vipDesc": "",
|
|||
|
|
"vipId": 0,
|
|||
|
|
"vipName": "",
|
|||
|
|
"vipType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymVipAddDto|新增体育馆会员卡表Dto|body|true|GymVipAdd对象|GymVipAdd对象|
|
|||
|
|
|  backgroundFileList|会员卡background文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  benefitNotice|权益说明;(0:否,1:是)||false|string||
|
|||
|
|
|  businessTypes|支持的项目||false|string||
|
|||
|
|
|  buyNotice|购买须知||false|string||
|
|||
|
|
|  endNo|会员卡号结束||false|integer(int64)||
|
|||
|
|
|  fieldIds|支持的场地||false|string||
|
|||
|
|
|  isRealAuth|是否实名制购卡;(0:否,1:是)||false|string||
|
|||
|
|
|  isSelf|是否仅限本人使用;(0:否,1:是)||false|string||
|
|||
|
|
|  issueNum|发卡数量||false|integer(int32)||
|
|||
|
|
|  logoFileList|会员卡LOGO文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  realAmout|会员卡储值金额||false|number||
|
|||
|
|
|  realNum|会员卡储值次数||false|integer(int32)||
|
|||
|
|
|  salePrice|会员卡售价||false|number||
|
|||
|
|
|  startNo|会员卡号起始||false|integer(int64)||
|
|||
|
|
|  useNotice|使用说明||false|string||
|
|||
|
|
|  validityTerm|有效期||false|integer(int32)||
|
|||
|
|
|  venueIds|支持的场馆||false|string||
|
|||
|
|
|  vipDesc|会员卡介绍||false|string||
|
|||
|
|
|  vipId|主键ID||false|integer(int64)||
|
|||
|
|
|  vipName|会员卡名称||false|string||
|
|||
|
|
|  vipType|会员卡类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改体育馆VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/vip`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"backgroundFileList": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"benefitNotice": "",
|
|||
|
|
"businessTypes": "",
|
|||
|
|
"buyNotice": "",
|
|||
|
|
"endNo": 0,
|
|||
|
|
"fieldIds": "",
|
|||
|
|
"isRealAuth": "",
|
|||
|
|
"isSelf": "",
|
|||
|
|
"issueNum": 0,
|
|||
|
|
"logoFileList": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"realAmout": 0,
|
|||
|
|
"realNum": 0,
|
|||
|
|
"salePrice": 0,
|
|||
|
|
"startNo": 0,
|
|||
|
|
"useNotice": "",
|
|||
|
|
"validityTerm": 0,
|
|||
|
|
"venueIds": "",
|
|||
|
|
"vipDesc": "",
|
|||
|
|
"vipId": 0,
|
|||
|
|
"vipName": "",
|
|||
|
|
"vipType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymVipEditDto|新增体育馆会员卡表Dto|body|true|GymVipAdd对象|GymVipAdd对象|
|
|||
|
|
|  backgroundFileList|会员卡background文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  benefitNotice|权益说明;(0:否,1:是)||false|string||
|
|||
|
|
|  businessTypes|支持的项目||false|string||
|
|||
|
|
|  buyNotice|购买须知||false|string||
|
|||
|
|
|  endNo|会员卡号结束||false|integer(int64)||
|
|||
|
|
|  fieldIds|支持的场地||false|string||
|
|||
|
|
|  isRealAuth|是否实名制购卡;(0:否,1:是)||false|string||
|
|||
|
|
|  isSelf|是否仅限本人使用;(0:否,1:是)||false|string||
|
|||
|
|
|  issueNum|发卡数量||false|integer(int32)||
|
|||
|
|
|  logoFileList|会员卡LOGO文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  realAmout|会员卡储值金额||false|number||
|
|||
|
|
|  realNum|会员卡储值次数||false|integer(int32)||
|
|||
|
|
|  salePrice|会员卡售价||false|number||
|
|||
|
|
|  startNo|会员卡号起始||false|integer(int64)||
|
|||
|
|
|  useNotice|使用说明||false|string||
|
|||
|
|
|  validityTerm|有效期||false|integer(int32)||
|
|||
|
|
|  venueIds|支持的场馆||false|string||
|
|||
|
|
|  vipDesc|会员卡介绍||false|string||
|
|||
|
|
|  vipId|主键ID||false|integer(int64)||
|
|||
|
|
|  vipName|会员卡名称||false|string||
|
|||
|
|
|  vipType|会员卡类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询体育馆VIP卡列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/vip/listByVip`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginSalePrice|会员卡售价起|query|false|number||
|
|||
|
|
|businessTypes|支持的项目|query|false|string||
|
|||
|
|
|endSalePrice|会员卡售价末|query|false|number||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|vipId|主键ID|query|false|integer(int64)||
|
|||
|
|
|vipName|会员卡名称|query|false|string||
|
|||
|
|
|vipStatus|会员卡状态|query|false|string||
|
|||
|
|
|vipType|会员卡类型|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## VIP卡上下架
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/vip/offline/{vipId}/{vipStatus}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipId|vipId|path|true|integer(int64)||
|
|||
|
|
|vipStatus|vipStatus|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询体育馆VIP卡详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/vip/{vipId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipId|vipId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除体育馆VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/vip/{vipId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipId|vipId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 体育馆场地
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增体育馆场地
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymField`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fieldArea": 0,
|
|||
|
|
"fieldBusiness": "",
|
|||
|
|
"fieldDesc": "",
|
|||
|
|
"fieldName": "",
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymFieldAddDto|体育馆场地Dto|body|true|GymFieldAddDto对象|GymFieldAddDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fieldArea|场地面积||false|integer(int32)||
|
|||
|
|
|  fieldBusiness|场地经营项目||false|string||
|
|||
|
|
|  fieldDesc|场地描述||false|string||
|
|||
|
|
|  fieldName|场地名称||false|string||
|
|||
|
|
|  fileList|文件List||false|array|新增或修改关联多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:场馆平面图)||true|string||
|
|||
|
|
|  venueId|场馆Id||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改体育馆场地
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymField`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fieldArea": 0,
|
|||
|
|
"fieldBusiness": "",
|
|||
|
|
"fieldDesc": "",
|
|||
|
|
"fieldId": 0,
|
|||
|
|
"fieldName": "",
|
|||
|
|
"fieldStatus": "",
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymFieldEditDto|博物馆场地Dto|body|true|GymFieldEditDto对象|GymFieldEditDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fieldArea|场地面积||false|integer(int32)||
|
|||
|
|
|  fieldBusiness|场地经营项目||false|string||
|
|||
|
|
|  fieldDesc|场地描述||false|string||
|
|||
|
|
|  fieldId|主键ID||false|integer(int64)||
|
|||
|
|
|  fieldName|场地名称||false|string||
|
|||
|
|
|  fieldStatus|场地状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|  fileList|文件List||false|array|新增或修改关联多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:场馆平面图)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 场地启用与停用
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymField/fieldStatus`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"fieldId": 0,
|
|||
|
|
"fieldStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymFieldStatusDto|体育馆场地状态Dto|body|true|GymFieldStatusDto对象|GymFieldStatusDto对象|
|
|||
|
|
|  fieldId|场地主键ID||false|integer(int64)||
|
|||
|
|
|  fieldStatus|场地状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询体育馆场地列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymField/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|venueId|场馆id|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取体育馆场地详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymField/{fieldId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fieldId|fieldId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除体育馆场地
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymField/{fieldId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fieldId|fieldId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 体育馆场馆
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增体育馆场馆
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymVenue`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"contactName": "",
|
|||
|
|
"contactTel": "",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"gymId": 0,
|
|||
|
|
"venueAddress": "",
|
|||
|
|
"venueArea": 0,
|
|||
|
|
"venueDesc": "",
|
|||
|
|
"venueName": "",
|
|||
|
|
"venueService": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymVenueAddDto|体育馆场馆Dto|body|true|GymVenueAddDto对象|GymVenueAddDto对象|
|
|||
|
|
|  contactName|联系人||false|string||
|
|||
|
|
|  contactTel|联系方式||false|string||
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileList|文件List||false|array|新增或修改关联多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:场馆平面图)||true|string||
|
|||
|
|
|  gymId|体育馆Id||false|integer(int64)||
|
|||
|
|
|  venueAddress|场馆地址||false|string||
|
|||
|
|
|  venueArea|场馆面积||false|integer(int32)||
|
|||
|
|
|  venueDesc|场馆描述||false|string||
|
|||
|
|
|  venueName|场馆名称||false|string||
|
|||
|
|
|  venueService|场馆服务||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改体育馆场馆
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymVenue`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"contactName": "",
|
|||
|
|
"contactTel": "",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"venueAddress": "",
|
|||
|
|
"venueArea": 0,
|
|||
|
|
"venueDesc": "",
|
|||
|
|
"venueId": 0,
|
|||
|
|
"venueName": "",
|
|||
|
|
"venueService": "",
|
|||
|
|
"venueStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymVenueEditDto|体育馆场馆Dto|body|true|GymVenueEditDto对象|GymVenueEditDto对象|
|
|||
|
|
|  contactName|联系人||false|string||
|
|||
|
|
|  contactTel|联系方式||false|string||
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileList|文件List||false|array|新增或修改关联多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:场馆平面图)||true|string||
|
|||
|
|
|  venueAddress|场馆地址||false|string||
|
|||
|
|
|  venueArea|场馆面积||false|integer(int32)||
|
|||
|
|
|  venueDesc|场馆描述||false|string||
|
|||
|
|
|  venueId|主键ID||false|integer(int64)||
|
|||
|
|
|  venueName|场馆名称||false|string||
|
|||
|
|
|  venueService|场馆服务||false|string||
|
|||
|
|
|  venueStatus|场馆状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询体育馆场馆列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymVenue/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|gymId|体育馆Id|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|venueStatus|场馆状态|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 场馆启用与停用
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymVenue/venueStatus`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"venueId": 0,
|
|||
|
|
"venueStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymVenueStatusDto|体育馆场馆Dto|body|true|GymVenueStatusDto对象|GymVenueStatusDto对象|
|
|||
|
|
|  venueId|场馆主键ID||false|integer(int64)||
|
|||
|
|
|  venueStatus|场馆状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取体育馆场馆详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymVenue/{venueId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|venueId|venueId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除体育馆场馆
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymVenue/{venueId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|venueId|venueId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 体育馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取体育馆基础详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBase`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增体育馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBase`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"alipayAccount": "",
|
|||
|
|
"areaCode": "",
|
|||
|
|
"cityCode": "",
|
|||
|
|
"gymAddress": "",
|
|||
|
|
"gymDesc": "",
|
|||
|
|
"gymId": 0,
|
|||
|
|
"gymLogo": "",
|
|||
|
|
"gymName": "",
|
|||
|
|
"payChannel": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"provinceCode": "",
|
|||
|
|
"themeColor": "",
|
|||
|
|
"wechatAppid": "",
|
|||
|
|
"wechatMchId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymBaseAddDto|体育馆基础Dto|body|true|GymBaseAddDto对象|GymBaseAddDto对象|
|
|||
|
|
|  alipayAccount|支付宝账号||false|string||
|
|||
|
|
|  areaCode|区编码||false|string||
|
|||
|
|
|  cityCode|市编码||false|string||
|
|||
|
|
|  gymAddress|体育馆地址||false|string||
|
|||
|
|
|  gymDesc|体育馆简介||false|string||
|
|||
|
|
|  gymId|主键ID||false|integer(int64)||
|
|||
|
|
|  gymLogo|体育馆LOGO||false|string||
|
|||
|
|
|  gymName|体育馆名称||false|string||
|
|||
|
|
|  payChannel|支付渠道||false|string||
|
|||
|
|
|  phone|手机号||false|string||
|
|||
|
|
|  provinceCode|省编码||false|string||
|
|||
|
|
|  themeColor|主题颜色||false|string||
|
|||
|
|
|  wechatAppid|微信APPID||false|string||
|
|||
|
|
|  wechatMchId|微信商户号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改体育馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBase`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"alipayAccount": "",
|
|||
|
|
"areaCode": "",
|
|||
|
|
"cityCode": "",
|
|||
|
|
"gymAddress": "",
|
|||
|
|
"gymDesc": "",
|
|||
|
|
"gymId": 0,
|
|||
|
|
"gymLogo": "",
|
|||
|
|
"gymName": "",
|
|||
|
|
"payChannel": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"provinceCode": "",
|
|||
|
|
"themeColor": "",
|
|||
|
|
"wechatAppid": "",
|
|||
|
|
"wechatMchId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymBaseEditDto|体育馆基础Dto|body|true|GymBaseAddDto对象|GymBaseAddDto对象|
|
|||
|
|
|  alipayAccount|支付宝账号||false|string||
|
|||
|
|
|  areaCode|区编码||false|string||
|
|||
|
|
|  cityCode|市编码||false|string||
|
|||
|
|
|  gymAddress|体育馆地址||false|string||
|
|||
|
|
|  gymDesc|体育馆简介||false|string||
|
|||
|
|
|  gymId|主键ID||false|integer(int64)||
|
|||
|
|
|  gymLogo|体育馆LOGO||false|string||
|
|||
|
|
|  gymName|体育馆名称||false|string||
|
|||
|
|
|  payChannel|支付渠道||false|string||
|
|||
|
|
|  phone|手机号||false|string||
|
|||
|
|
|  provinceCode|省编码||false|string||
|
|||
|
|
|  themeColor|主题颜色||false|string||
|
|||
|
|
|  wechatAppid|微信APPID||false|string||
|
|||
|
|
|  wechatMchId|微信商户号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取行政区域
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBase/getAddress`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|parentCode|父地区编码|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询体育馆基础列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBase/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除体育馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBase/{gymId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymId|gymId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台体育馆VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询体育馆VIP卡列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/vip/noLogin/listByVip`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginSalePrice|会员卡售价起|query|false|number||
|
|||
|
|
|businessTypes|支持的项目|query|false|string||
|
|||
|
|
|endSalePrice|会员卡售价末|query|false|number||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|vipId|主键ID|query|false|integer(int64)||
|
|||
|
|
|vipName|会员卡名称|query|false|string||
|
|||
|
|
|vipStatus|会员卡状态|query|false|string||
|
|||
|
|
|vipType|会员卡类型|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询体育馆VIP卡详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/vip/noLogin/{vipId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipId|vipId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台体育馆场馆
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取体育馆场馆详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymVenue/noLogin/venue`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|venueId|venueId|query|true|integer(int64)||
|
|||
|
|
|businessId|businessId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 添加收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataCollection/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCollectionAddDto|dataCollectionAddDto|body|true|添加收藏Dto|添加收藏Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|收藏类型 2:场馆,4:文章||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataCollection/del/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询我的收藏列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataCollection/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|collectionBy|收藏人|query|false|string||
|
|||
|
|
|dataName|收藏名称|query|false|string||
|
|||
|
|
|dataType|收藏类型 2:场馆,4:文章|query|false|string||
|
|||
|
|
|reqType|请求类型{0:后台,1:前台}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台文章管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取用户服务协议和隐私政策(contentType 1:用户服务协议,2:隐私政策)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymArticle/noLogin/getAgreementAndPolicy`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|contentType|contentType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取体育馆展馆概况
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymArticle/noLogin/getGymSituation`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询文章列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymArticle/noLogin/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleModule|所属模块(1:新闻动态,2:活动发布|query|false|string||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取文章详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymArticle/noLogin/{articleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleId|articleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 添加点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataPraise/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataPraiseAddDto|dataPraiseAddDto|body|true|添加点赞Dto|添加点赞Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|点赞类型 2:场馆,4:文章||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataPraise/del/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询我的点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataPraise/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|收藏类型 2:场馆,4:文章|query|false|string||
|
|||
|
|
|praiseBy|点赞人|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台用户VIP使用
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台新增用户VIP使用(类似订单)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/use`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"cardId": 0,
|
|||
|
|
"cardNo": 0,
|
|||
|
|
"reserveId": 0,
|
|||
|
|
"useAmout": 0,
|
|||
|
|
"useId": 0,
|
|||
|
|
"useNum": 0,
|
|||
|
|
"useRemark": "",
|
|||
|
|
"useStatus": "",
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userId": 0,
|
|||
|
|
"userName": "",
|
|||
|
|
"userNickName": "",
|
|||
|
|
"userOpenId": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userRealName": "",
|
|||
|
|
"vipEndDate": "",
|
|||
|
|
"vipId": 0,
|
|||
|
|
"vipStartDate": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardUseAddDto|新增用户VIP使用表Dto|body|true|CardUseAddDto对象|CardUseAddDto对象|
|
|||
|
|
|  cardId|用户卡ID||false|integer(int64)||
|
|||
|
|
|  cardNo|会员卡卡号||false|integer(int64)||
|
|||
|
|
|  reserveId|预约ID||false|integer(int64)||
|
|||
|
|
|  useAmout|使用金额||false|number||
|
|||
|
|
|  useId|主键ID||false|integer(int64)||
|
|||
|
|
|  useNum|使用次数||false|integer(int32)||
|
|||
|
|
|  useRemark|使用备注||false|string||
|
|||
|
|
|  useStatus|使用状态||false|string||
|
|||
|
|
|  userCardNo|用户身份证号码||false|string||
|
|||
|
|
|  userCardType|用户证件类型||false|string||
|
|||
|
|
|  userId|用户ID||false|integer(int64)||
|
|||
|
|
|  userName|用户名称||false|string||
|
|||
|
|
|  userNickName|用户昵称||false|string||
|
|||
|
|
|  userOpenId|用户微信ID||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userRealName|用户真实姓名||false|string||
|
|||
|
|
|  vipEndDate|VIP有效期截止||false|string(date-time)||
|
|||
|
|
|  vipId|会员卡ID||false|integer(int64)||
|
|||
|
|
|  vipStartDate|VIP有效期起始||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询用户VIP使用(类似订单)列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/use/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardNo|会员卡卡号|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|useId|会员卡使用Id|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户VIP已使用金额
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/use/money`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|会员卡ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|useId|主键ID|query|false|integer(int64)||
|
|||
|
|
|vipId|会员卡ID|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## vip使用退款
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/use/refund/{useId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|useId|useId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取用户VIP使用(类似订单)详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/use/{useId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|useId|useId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台用户VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台新增用户VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"cardId": 0,
|
|||
|
|
"cardNo": 0,
|
|||
|
|
"reserveId": 0,
|
|||
|
|
"useNum": 0,
|
|||
|
|
"userAmout": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userCardAddDto|修改用户VIP表Dto|body|true|UserCardAddDto|UserCardAddDto|
|
|||
|
|
|  cardId|用户卡Id||false|integer(int64)||
|
|||
|
|
|  cardNo|会员卡卡号||false|integer(int64)||
|
|||
|
|
|  reserveId|预约Id||false|integer(int64)||
|
|||
|
|
|  useNum|会员卡扣除次数||false|integer(int32)||
|
|||
|
|
|  userAmout|会员卡扣除金额||false|number||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台修改用户VIP卡(付钱)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"cardId": 0,
|
|||
|
|
"cardNo": 0,
|
|||
|
|
"reserveId": 0,
|
|||
|
|
"useNum": 0,
|
|||
|
|
"userAmout": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userCardEditDto|修改用户VIP表Dto|body|true|UserCardAddDto|UserCardAddDto|
|
|||
|
|
|  cardId|用户卡Id||false|integer(int64)||
|
|||
|
|
|  cardNo|会员卡卡号||false|integer(int64)||
|
|||
|
|
|  reserveId|预约Id||false|integer(int64)||
|
|||
|
|
|  useNum|会员卡扣除次数||false|integer(int32)||
|
|||
|
|
|  userAmout|会员卡扣除金额||false|number||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询可支付VIP卡列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/listByAnyId`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|经营项目类型|query|false|string||
|
|||
|
|
|fieldId|场地Id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|venueId|场馆Id|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询用户VIP卡列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/listByCard`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|主键Id|query|false|integer(int64)||
|
|||
|
|
|cardNo|会员卡卡号|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询用户VIP卡适用场馆列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/listByCardId`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|vipId|vipId|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询VIP卡使用记录
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/listByCardNo`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|主键Id|query|false|integer(int64)||
|
|||
|
|
|cardNo|会员卡卡号|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/member/{cardId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|cardId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取用户VIP卡详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/vip/{cardId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|cardId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取用户VIP卡详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/card/{cardId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|cardId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台用户VIP购买
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台新增体育场vip购买
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/base`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"orderRemark": "",
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userRealName": "",
|
|||
|
|
"vipId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipBaseAddDto|新增用户VIP购买表|body|true|VipBaseAddDto对象|VipBaseAddDto对象|
|
|||
|
|
|  orderRemark|订单备注||false|string||
|
|||
|
|
|  totalAmout|订单金额||false|number||
|
|||
|
|
|  userCardNo|用户身份证号码||false|string||
|
|||
|
|
|  userCardType|用户证件类型||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userRealName|用户真实姓名||false|string||
|
|||
|
|
|  vipId|会员卡名称||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询用户VIP购买(订单)列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/base/listByOrder`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string(date-time)||
|
|||
|
|
|endTime|结束时间|query|false|string(date-time)||
|
|||
|
|
|orderId|主键ID|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|totalAmout|订单金额|query|false|number||
|
|||
|
|
|vipName|会员卡名称|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## VIP卡订单支付
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/base/toPay`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"beginTime": "",
|
|||
|
|
"endTime": "",
|
|||
|
|
"orderId": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"vipName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipBaseListDto|查询用户VIP购买表|body|true|VipBaseListDto对象|VipBaseListDto对象|
|
|||
|
|
|  beginTime|开始时间||false|string(date-time)||
|
|||
|
|
|  endTime|结束时间||false|string(date-time)||
|
|||
|
|
|  orderId|主键ID||false|integer(int64)||
|
|||
|
|
|  pageNum|分页参数||false|integer(int32)||
|
|||
|
|
|  pageSize|分页参数||false|integer(int32)||
|
|||
|
|
|  totalAmout|订单金额||false|number||
|
|||
|
|
|  vipName|会员卡名称||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取用户VIP购买详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/base/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataComment/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"commentContent": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCommentAddDTO|dataCommentAddDTO|body|true|添加评论Dto|添加评论Dto|
|
|||
|
|
|  commentContent|评论内容||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型 8:订单,4:文章||false|string||
|
|||
|
|
|  venueId|场馆ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataComment/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"commentContent": "",
|
|||
|
|
"commentId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCommentEditDto|dataCommentEditDto|body|true|修改评论|修改评论|
|
|||
|
|
|  commentContent|评论内容||false|string||
|
|||
|
|
|  commentId|评论ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询我的评论列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataComment/myList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentBy|评论者|query|false|string||
|
|||
|
|
|commentStatus|评论状态 0初始,1通过,2不通过|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章和订单评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataComment/noLogin/articleList/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询场馆评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/dataComment/noLogin/venueList/{venueId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|venueId|venueId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台预约场地配置管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询开放预约的所有经营项目类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymBusiness/noLogin/businessTypeList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询体育馆预约场地配置列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymBusiness/noLogin/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|经营项目类型;(1:足球,2:篮球,3:羽毛球,4:网球,5:乒乓球,6:游泳,7:健身,8:桌球,9:拳击,10:击剑,11:其他)|query|true|string||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取可预约日期列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymBusiness/noLogin/orderDateList/{businessId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessId|businessId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取可预约场地列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymBusiness/noLogin/orderFieldList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessId|预约场地配置ID|query|false|integer(int64)||
|
|||
|
|
|date|预约日期|query|false|string(date)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取体育馆预约场地配置详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/gymBusiness/noLogin/{businessId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessId|businessId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 后台用户VIP使用
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 后台查询用户VIP使用列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/use/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardNo|会员卡卡号|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|useId|会员卡使用Id|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 后台获取用户VIP使用详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/use/{useId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|useId|useId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 多媒体文件管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增多媒体文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileDesc": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileType": 1,
|
|||
|
|
"fileUrl": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFileAddDto|museumFileAddDto|body|true|新增多媒体文件Dto|新增多媒体文件Dto|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileDesc|文件简介||true|string||
|
|||
|
|
|  fileName|文件名称||true|string||
|
|||
|
|
|  fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  fileUrl|文件路径(相对)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改多媒体文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileDesc": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFileEditDto|museumFileEditDto|body|true|修改多媒体文件Dto|修改多媒体文件Dto|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileDesc|文件简介||false|string||
|
|||
|
|
|  fileId|文件ID||true|integer(int64)||
|
|||
|
|
|  fileName|文件名称||false|string||
|
|||
|
|
|  fileUrl|文件路径(相对)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 判断文件是否已经存在
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile/isExist`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileName|文件名称|query|true|string||
|
|||
|
|
|fileType|文件类型(1:图片,2:视频,3:音频,4:模型)|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 判断文件是否被引用
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile/isQuote/{fileIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileIds|fileIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询多媒体文件列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|操作开始时间|query|false|string(date)||
|
|||
|
|
|endTime|操作结束时间|query|false|string(date)||
|
|||
|
|
|fileName|文件名称|query|false|string||
|
|||
|
|
|fileType|文件类型(1:图片,2:视频,3:音频,4:模型)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除多媒体文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile/{fileIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileIds|fileIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取多媒体文件详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymFile/{fileId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileId|fileId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 推送记录
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量删除推送数据
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymRecord/deletes`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ids|ids|query|false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取推送数据详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymRecord/info`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|activeStatus||query|false|string||
|
|||
|
|
|createEnd|注册时间 :结束日期(10)|query|false|string||
|
|||
|
|
|createStart|注册时间 :开始日期(10)|query|false|string||
|
|||
|
|
|dataType|数据类型:2:场馆, 3:场地|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|fieldName|场地名称(10)|query|false|string||
|
|||
|
|
|pushId|pushId|query|false|integer(int64)||
|
|||
|
|
|pushTag|推送标签|query|false|string||
|
|||
|
|
|reserveType|预约类型(10)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userAddress||query|false|string||
|
|||
|
|
|venueName|场馆名称(10)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取推送数据记录列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymRecord/recordList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|数据类型|query|false|string||
|
|||
|
|
|pushStatus|推送状态,0:未推送,1:已推送|query|false|string||
|
|||
|
|
|pushTimeEnd|推送时间止|query|false|string(date-time)||
|
|||
|
|
|pushTimeStart|推送时间起|query|false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除推送数据
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymRecord/update`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|pushId|pushId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 支付相关
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 支付信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/userPay/getPay/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 支付结果通知(应为第三方回调接口,接入后修改)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/userPay/noLogin/payCallBack/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退款结果通知(应与支付结果通知统一,需接入后修改)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/userPay/noLogin/refundCallBack`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|type|type|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 去支付
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/userPay/toPay`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"orderId": 0,
|
|||
|
|
"orderType": "",
|
|||
|
|
"payAmout": 0,
|
|||
|
|
"payChannel": "",
|
|||
|
|
"payMethod": "",
|
|||
|
|
"payType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addDto|addDto|body|true|UserPayAddDto|UserPayAddDto|
|
|||
|
|
|  orderId|订单ID||false|integer(int64)||
|
|||
|
|
|  orderType|订单类型{1:展览预约订单 2:会员卡}||false|string||
|
|||
|
|
|  payAmout|支付金额||false|number||
|
|||
|
|
|  payChannel|支付渠道{ 1:微信 }||false|string||
|
|||
|
|
|  payMethod|支付方式{1:微信}||false|string||
|
|||
|
|
|  payType|支付类型{1:线上购买 2:现场购买}||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询会员收藏列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataCollection/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|collectionBy|收藏人|query|false|string||
|
|||
|
|
|dataName|收藏名称|query|false|string||
|
|||
|
|
|dataType|收藏类型 2:场馆,4:文章|query|false|string||
|
|||
|
|
|reqType|请求类型{0:后台,1:前台}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增保存数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|新增数据审核Dto|新增数据审核Dto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量新增数据审核(批量审核)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/adds`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dtos|dtos|body|true|array|新增数据审核Dto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|新增数据审核Dto|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|approvalDesc|审核描述|string||
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|dataId|数据ID|integer(int64)|integer(int64)|
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|修改数据审核Dto|修改数据审核Dto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalId|审批ID||false|integer(int64)||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量修改数据审核(批量审核)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/edits`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dtos|dtos|body|true|array|修改数据审核Dto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalId|审批ID||false|integer(int64)||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|修改数据审核Dto|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|approvalDesc|审核描述|string||
|
|||
|
|
|approvalId|审批ID|integer(int64)|integer(int64)|
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据审核列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|approvalEnd|结束时间:审核时间|query|false|string(date)||
|
|||
|
|
|approvalStart|开始时间:审核时间|query|false|string(date)||
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|query|false|string||
|
|||
|
|
|dataType|数据类型|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|PageInfo«数据审核列表Vo»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|endRow||integer(int64)|integer(int64)|
|
|||
|
|
|hasNextPage||boolean||
|
|||
|
|
|hasPreviousPage||boolean||
|
|||
|
|
|isFirstPage||boolean||
|
|||
|
|
|isLastPage||boolean||
|
|||
|
|
|list||array|数据审核列表Vo|
|
|||
|
|
|  approvalBy|审核者|string||
|
|||
|
|
|  approvalDesc|审核描述|string||
|
|||
|
|
|  approvalId|审批ID|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|  approvalTime|审核时间|string(date-time)||
|
|||
|
|
|  dataId|数据ID|string||
|
|||
|
|
|  dataType|数据类型|string||
|
|||
|
|
|  delFlag|删除标识;(0:未删除,1:已删除)|string||
|
|||
|
|
|  isCurr|是否最新审核记录;(0:否,1:是)|string||
|
|||
|
|
|  tenantId|租户ID|string||
|
|||
|
|
|navigateFirstPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigateLastPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigatePages||integer(int32)|integer(int32)|
|
|||
|
|
|navigatepageNums||array||
|
|||
|
|
|nextPage||integer(int32)|integer(int32)|
|
|||
|
|
|pageNum||integer(int32)|integer(int32)|
|
|||
|
|
|pageSize||integer(int32)|integer(int32)|
|
|||
|
|
|pages||integer(int32)|integer(int32)|
|
|||
|
|
|prePage||integer(int32)|integer(int32)|
|
|||
|
|
|size||integer(int32)|integer(int32)|
|
|||
|
|
|startRow||integer(int64)|integer(int64)|
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"endRow": 0,
|
|||
|
|
"hasNextPage": true,
|
|||
|
|
"hasPreviousPage": true,
|
|||
|
|
"isFirstPage": true,
|
|||
|
|
"isLastPage": true,
|
|||
|
|
"list": [
|
|||
|
|
{
|
|||
|
|
"approvalBy": "",
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"approvalTime": "",
|
|||
|
|
"dataId": "",
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"isCurr": "",
|
|||
|
|
"tenantId": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"navigateFirstPage": 0,
|
|||
|
|
"navigateLastPage": 0,
|
|||
|
|
"navigatePages": 0,
|
|||
|
|
"navigatepageNums": [],
|
|||
|
|
"nextPage": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"pages": 0,
|
|||
|
|
"prePage": 0,
|
|||
|
|
"size": 0,
|
|||
|
|
"startRow": 0,
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据审核详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/{approvalId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|approvalId|approvalId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|数据审核详情Vo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|approvalBy|审核者|string||
|
|||
|
|
|approvalDesc|审核描述|string||
|
|||
|
|
|approvalId|审批ID|string||
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|approvalTime|审核时间|string(date-time)|string(date-time)|
|
|||
|
|
|dataId|数据ID|string||
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|delFlag|删除标识;(0:未删除,1:已删除)|string||
|
|||
|
|
|tenantId|租户ID|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalBy": "",
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"approvalTime": "",
|
|||
|
|
"dataId": "",
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"tenantId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataApproval/{approvalId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|approvalId|approvalId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 数据推荐关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增保存数据推荐关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataRecommendRel/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|新增数据推荐关联Dto|新增数据推荐关联Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  recommendId|推荐数据ID||false|integer(int64)||
|
|||
|
|
|  recommendType|推荐数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据推荐关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataRecommendRel/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": "",
|
|||
|
|
"relId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|修改数据推荐关联Dto|修改数据推荐关联Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  recommendId|推荐数据ID||false|integer(int64)||
|
|||
|
|
|  recommendType|推荐数据类型||false|string||
|
|||
|
|
|  relId|关联ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据数据类型获取数据名称列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataRecommendRel/getRecommendDataList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|数据类型(2:场馆;3:场地,4:文章,11:图片,12:视频,13:音频;14:场馆平面图)|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据推荐关联列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataRecommendRel/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createEnd|结束时间 :开始日期 yyyy-MM-dd HH:mm:ss|query|false|string||
|
|||
|
|
|createStart|开始时间 :开始日期 yyyy-MM-dd HH:mm:ss|query|false|string||
|
|||
|
|
|dataType|数据类型|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|PageInfo«数据推荐关联列表Vo»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|endRow||integer(int64)|integer(int64)|
|
|||
|
|
|hasNextPage||boolean||
|
|||
|
|
|hasPreviousPage||boolean||
|
|||
|
|
|isFirstPage||boolean||
|
|||
|
|
|isLastPage||boolean||
|
|||
|
|
|list||array|数据推荐关联列表Vo|
|
|||
|
|
|  createBy|创建者|string||
|
|||
|
|
|  createTime|创建时间|string(date-time)||
|
|||
|
|
|  dataId|数据ID|string||
|
|||
|
|
|  dataType|数据类型|string||
|
|||
|
|
|  delFlag|删除标志;(0:未删除,1:已删除)|string||
|
|||
|
|
|  recommendId|推荐数据ID|string||
|
|||
|
|
|  recommendType|推荐数据类型|string||
|
|||
|
|
|  relId|关联ID|string||
|
|||
|
|
|  tenantId|租户ID|string||
|
|||
|
|
|navigateFirstPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigateLastPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigatePages||integer(int32)|integer(int32)|
|
|||
|
|
|navigatepageNums||array||
|
|||
|
|
|nextPage||integer(int32)|integer(int32)|
|
|||
|
|
|pageNum||integer(int32)|integer(int32)|
|
|||
|
|
|pageSize||integer(int32)|integer(int32)|
|
|||
|
|
|pages||integer(int32)|integer(int32)|
|
|||
|
|
|prePage||integer(int32)|integer(int32)|
|
|||
|
|
|size||integer(int32)|integer(int32)|
|
|||
|
|
|startRow||integer(int64)|integer(int64)|
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"endRow": 0,
|
|||
|
|
"hasNextPage": true,
|
|||
|
|
"hasPreviousPage": true,
|
|||
|
|
"isFirstPage": true,
|
|||
|
|
"isLastPage": true,
|
|||
|
|
"list": [
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataId": "",
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"recommendId": "",
|
|||
|
|
"recommendType": "",
|
|||
|
|
"relId": "",
|
|||
|
|
"tenantId": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"navigateFirstPage": 0,
|
|||
|
|
"navigateLastPage": 0,
|
|||
|
|
"navigatePages": 0,
|
|||
|
|
"navigatepageNums": [],
|
|||
|
|
"nextPage": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"pages": 0,
|
|||
|
|
"prePage": 0,
|
|||
|
|
"size": 0,
|
|||
|
|
"startRow": 0,
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据文件关联详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataRecommendRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|数据推荐关联详情Vo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|createBy|创建者|string||
|
|||
|
|
|createTime|创建时间|string(date-time)|string(date-time)|
|
|||
|
|
|dataId|数据ID|string||
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|delFlag|删除标志;(0:未删除,1:已删除)|string||
|
|||
|
|
|recommendId|推荐数据ID|string||
|
|||
|
|
|recommendType|推荐数据类型|string||
|
|||
|
|
|relId|关联ID|string||
|
|||
|
|
|tenantId|租户ID|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataId": "",
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"recommendId": "",
|
|||
|
|
"recommendType": "",
|
|||
|
|
"relId": "",
|
|||
|
|
"tenantId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataRecommendRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增保存数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataFileRel/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|新增数据文件关联Dto|新增数据文件关联Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  fileId|文件ID||false|integer(int64)||
|
|||
|
|
|  fileType|文件类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataFileRel/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": "",
|
|||
|
|
"relId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|修改数据文件关联Dto|修改数据文件关联Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  fileId|文件ID||false|integer(int64)||
|
|||
|
|
|  fileType|文件类型||false|string||
|
|||
|
|
|  relId|关联ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据文件关联列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataFileRel/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|query|false|integer(int64)||
|
|||
|
|
|fileType|fileType|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|PageInfo«关联文件详情Vo»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|endRow||integer(int64)|integer(int64)|
|
|||
|
|
|hasNextPage||boolean||
|
|||
|
|
|hasPreviousPage||boolean||
|
|||
|
|
|isFirstPage||boolean||
|
|||
|
|
|isLastPage||boolean||
|
|||
|
|
|list||array|关联文件详情Vo|
|
|||
|
|
|  fileDesc|关联文件简介|string||
|
|||
|
|
|  fileId|关联文件ID|string||
|
|||
|
|
|  fileName|关联文件名称|string||
|
|||
|
|
|  fileType|关联文件类型(1:图片,2:视频,3:音频,4:模型)|string||
|
|||
|
|
|  fileUrl|关联文件路径|string||
|
|||
|
|
|  videoAndModelFileCover|视频、模型文件封面|封面文件详情Vo|封面文件详情Vo|
|
|||
|
|
|    fileId|封面文件ID|string||
|
|||
|
|
|    fileName|封面文件名称|string||
|
|||
|
|
|    fileUrl|封面文件路径|string||
|
|||
|
|
|navigateFirstPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigateLastPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigatePages||integer(int32)|integer(int32)|
|
|||
|
|
|navigatepageNums||array||
|
|||
|
|
|nextPage||integer(int32)|integer(int32)|
|
|||
|
|
|pageNum||integer(int32)|integer(int32)|
|
|||
|
|
|pageSize||integer(int32)|integer(int32)|
|
|||
|
|
|pages||integer(int32)|integer(int32)|
|
|||
|
|
|prePage||integer(int32)|integer(int32)|
|
|||
|
|
|size||integer(int32)|integer(int32)|
|
|||
|
|
|startRow||integer(int64)|integer(int64)|
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"endRow": 0,
|
|||
|
|
"hasNextPage": true,
|
|||
|
|
"hasPreviousPage": true,
|
|||
|
|
"isFirstPage": true,
|
|||
|
|
"isLastPage": true,
|
|||
|
|
"list": [
|
|||
|
|
{
|
|||
|
|
"fileDesc": "",
|
|||
|
|
"fileId": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileType": 1,
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"videoAndModelFileCover": {
|
|||
|
|
"fileId": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": ""
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"navigateFirstPage": 0,
|
|||
|
|
"navigateLastPage": 0,
|
|||
|
|
"navigatePages": 0,
|
|||
|
|
"navigatepageNums": [],
|
|||
|
|
"nextPage": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"pages": 0,
|
|||
|
|
"prePage": 0,
|
|||
|
|
"size": 0,
|
|||
|
|
"startRow": 0,
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据文件关联详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataFileRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|数据文件关联详情Vo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|createBy|创建者|string||
|
|||
|
|
|createTime|创建时间|string(date-time)|string(date-time)|
|
|||
|
|
|dataId|数据ID|string||
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|delFlag|删除标志;(0:未删除,1:已删除)|string||
|
|||
|
|
|fileId|文件ID|string||
|
|||
|
|
|fileName|文件名称|string||
|
|||
|
|
|fileType|文件类型|string||
|
|||
|
|
|relId|关联ID|string||
|
|||
|
|
|tenantId|租户ID|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataId": "",
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"fileId": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileType": "",
|
|||
|
|
"relId": "",
|
|||
|
|
"tenantId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataFileRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 文章管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增文章
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"articleContent": "",
|
|||
|
|
"articleDesc": "",
|
|||
|
|
"articleModule": 1,
|
|||
|
|
"articleName": "",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"isComment": 1,
|
|||
|
|
"isPraise": 1,
|
|||
|
|
"isTop": 0,
|
|||
|
|
"relDataList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"relFileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"saveOrSubmit": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymArticleAddDto|gymArticleAddDto|body|true|新增文章Dto|新增文章Dto|
|
|||
|
|
|  articleContent|文章内容(活动详情)||false|string||
|
|||
|
|
|  articleDesc|文章简介(活动地点)||false|string||
|
|||
|
|
|  articleModule|所属模块(1:新闻动态,2:活动发布,3:体育馆介绍,4:用户服务协议,5:隐私政策)||false|string||
|
|||
|
|
|  articleName|文章名称(活动名称)||false|string||
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  isComment|是否允许评论;(0:否,1:是)||false|string||
|
|||
|
|
|  isPraise|是否允许点赞;(0:否,1:是)||false|string||
|
|||
|
|
|  isTop|是否置顶;(0:否,1:是)||false|string||
|
|||
|
|
|  relDataList|推荐内容列表||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  relFileList|关联文件列表(不包含封面图片)||false|array|新增或修改关联多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:场馆平面图)||true|string||
|
|||
|
|
|  saveOrSubmit|操作(1:保存,2:提交)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改文章
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"articleContent": "",
|
|||
|
|
"articleDesc": "",
|
|||
|
|
"articleId": 0,
|
|||
|
|
"articleModule": 1,
|
|||
|
|
"articleName": "",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"isComment": 1,
|
|||
|
|
"isPraise": 1,
|
|||
|
|
"isTop": 0,
|
|||
|
|
"relDataList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"relFileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"saveOrSubmit": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymArticleEditDto|gymArticleEditDto|body|true|修改文章Dto|修改文章Dto|
|
|||
|
|
|  articleContent|文章内容||false|string||
|
|||
|
|
|  articleDesc|文章简介||false|string||
|
|||
|
|
|  articleId|文章ID||true|integer(int64)||
|
|||
|
|
|  articleModule|所属模块(1:新闻动态,2:活动发布,3:体育馆介绍,4:用户服务协议,5:隐私政策)||false|string||
|
|||
|
|
|  articleName|文章名称||false|string||
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  isComment|是否允许评论;(0:否,1:是)||false|string||
|
|||
|
|
|  isPraise|是否允许点赞;(0:否,1:是)||false|string||
|
|||
|
|
|  isTop|是否置顶;(0:否,1:是)||false|string||
|
|||
|
|
|  relDataList|推荐内容列表||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  relFileList|关联文件列表(不包含封面图片)||false|array|新增或修改关联多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:场馆平面图)||true|string||
|
|||
|
|
|  saveOrSubmit|操作(1:保存,2:提交)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/approve`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approveOpinion": "",
|
|||
|
|
"approveStatus": "",
|
|||
|
|
"articleId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymArticleApproveDto|gymArticleApproveDto|body|true|文章审核Dto|文章审核Dto|
|
|||
|
|
|  approveOpinion|审核意见||false|string||
|
|||
|
|
|  approveStatus|审核操作(1:通过,2:驳回)||true|string||
|
|||
|
|
|  articleId|文章ID||true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出查询文章列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleModule|所属模块(1:新闻动态,2:活动发布,3:体育馆介绍,4:用户服务协议,5:隐私政策)|query|false|string||
|
|||
|
|
|articleName|文章名称|query|false|string||
|
|||
|
|
|articleStatus|文章状态;(0:待审核,1:已上架,2:已下架,4:已驳回,9:草稿)|query|false|array|string|
|
|||
|
|
|createBy|发布者名称|query|false|string||
|
|||
|
|
|isTop|是否置顶;(0:否,1:是)|query|false|string||
|
|||
|
|
|onlineBeginTime|发布开始时间|query|false|string(date)||
|
|||
|
|
|onlineEndTime|发布结束时间|query|false|string(date)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBeginTime|编辑开始时间|query|false|string(date)||
|
|||
|
|
|updateEndTime|编辑结束时间|query|false|string(date)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleModule|所属模块(1:新闻动态,2:活动发布,3:体育馆介绍,4:用户服务协议,5:隐私政策)|query|false|string||
|
|||
|
|
|articleName|文章名称|query|false|string||
|
|||
|
|
|articleStatus|文章状态;(0:待审核,1:已上架,2:已下架,4:已驳回,9:草稿)|query|false|array|string|
|
|||
|
|
|createBy|发布者名称|query|false|string||
|
|||
|
|
|isTop|是否置顶;(0:否,1:是)|query|false|string||
|
|||
|
|
|onlineBeginTime|发布开始时间|query|false|string(date)||
|
|||
|
|
|onlineEndTime|发布结束时间|query|false|string(date)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBeginTime|编辑开始时间|query|false|string(date)||
|
|||
|
|
|updateEndTime|编辑结束时间|query|false|string(date)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章下架
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/offline/{articleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleId|articleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章置顶与取消置顶
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/toTop`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"articleId": 0,
|
|||
|
|
"isTop": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymArticleToTopDto|gymArticleToTopDto|body|true|文章置顶与取消Dto|文章置顶与取消Dto|
|
|||
|
|
|  articleId|文章ID||true|integer(int64)||
|
|||
|
|
|  isTop|置顶操作(1:置顶,2:取消置顶)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除文章
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/{articleIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleIds|articleIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取文章详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymArticle/{articleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleId|articleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 消息推送
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 筛选场地用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gym/message/field`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|activeStatus||query|false|string||
|
|||
|
|
|createEnd|注册时间 :结束日期(10)|query|false|string||
|
|||
|
|
|createStart|注册时间 :开始日期(10)|query|false|string||
|
|||
|
|
|dataType|数据类型:2:场馆, 3:场地|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|fieldName|场地名称(10)|query|false|string||
|
|||
|
|
|pushTag|推送标签|query|false|string||
|
|||
|
|
|reserveType|预约类型(10)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userAddress||query|false|string||
|
|||
|
|
|venueName|场馆名称(10)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 对用户消息进行推送
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gym/message/push`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|activeStatus||query|false|string||
|
|||
|
|
|createEnd|注册时间 :结束日期(10)|query|false|string||
|
|||
|
|
|createStart|注册时间 :开始日期(10)|query|false|string||
|
|||
|
|
|dataType|数据类型: 3:场地|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|fieldName|场地名称(10)|query|false|string||
|
|||
|
|
|messageContent|消息模板内容|query|false|string||
|
|||
|
|
|messageType|消息模板类型,1:验证码,2:短信通知,3:推广短信|query|false|string||
|
|||
|
|
|planTime|预定计划时间|query|false|string(date-time)||
|
|||
|
|
|pushId|消息推送ID|query|false|integer(int64)||
|
|||
|
|
|pushNum|人数|query|false|integer(int32)||
|
|||
|
|
|pushTag|推送标签|query|false|string||
|
|||
|
|
|pushType|推送类型,1:立即推送,2:定时推送|query|false|string||
|
|||
|
|
|reserveType|预约类型(10)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userAddress||query|false|string||
|
|||
|
|
|venueName|场馆名称(10)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 用户VIP卡
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改用户VIP
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/card`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"cardId": 0,
|
|||
|
|
"cardNo": 0,
|
|||
|
|
"reserveId": 0,
|
|||
|
|
"useNum": 0,
|
|||
|
|
"userAmout": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userCardEditDto|修改用户VIP表Dto|body|true|UserCardAddDto|UserCardAddDto|
|
|||
|
|
|  cardId|用户卡Id||false|integer(int64)||
|
|||
|
|
|  cardNo|会员卡卡号||false|integer(int64)||
|
|||
|
|
|  reserveId|预约Id||false|integer(int64)||
|
|||
|
|
|  useNum|会员卡扣除次数||false|integer(int32)||
|
|||
|
|
|  userAmout|会员卡扣除金额||false|number||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 后台查询用户VIP列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/card/listByCard`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|主键Id|query|false|integer(int64)||
|
|||
|
|
|cardNo|会员卡卡号|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户VIP详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/card/{cardId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|cardId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除用户VIP
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/card/{cardId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardId|cardId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 用户VIP购买
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改用户VIP购买
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/base`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"cardNo": 0,
|
|||
|
|
"isPay": "",
|
|||
|
|
"isReturn": "",
|
|||
|
|
"orderId": 0,
|
|||
|
|
"orderRemark": "",
|
|||
|
|
"orderStatus": "",
|
|||
|
|
"payType": "",
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userId": 0,
|
|||
|
|
"userName": "",
|
|||
|
|
"userNickName": "",
|
|||
|
|
"userOpenId": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userRealName": "",
|
|||
|
|
"vipEndDate": "",
|
|||
|
|
"vipId": 0,
|
|||
|
|
"vipStartDate": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|vipBaseEditDto|修改用户VIP购买表|body|true|VipBaseEditDto对象|VipBaseEditDto对象|
|
|||
|
|
|  cardNo|会员卡卡号||false|integer(int64)||
|
|||
|
|
|  isPay|是否购票;(0:否,1:是)||false|string||
|
|||
|
|
|  isReturn|退订状态||false|string||
|
|||
|
|
|  orderId|主键ID||false|integer(int64)||
|
|||
|
|
|  orderRemark|订单备注||false|string||
|
|||
|
|
|  orderStatus|订单状态||false|string||
|
|||
|
|
|  payType|付款方式||false|string||
|
|||
|
|
|  totalAmout|订单金额||false|number||
|
|||
|
|
|  userCardNo|用户身份证号码||false|string||
|
|||
|
|
|  userCardType|用户证件类型||false|string||
|
|||
|
|
|  userId|用户ID||false|integer(int64)||
|
|||
|
|
|  userName|用户名称||false|string||
|
|||
|
|
|  userNickName|用户昵称||false|string||
|
|||
|
|
|  userOpenId|用户微信ID||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userRealName|用户真实姓名||false|string||
|
|||
|
|
|  vipEndDate|VIP有效期截止||false|string(date-time)||
|
|||
|
|
|  vipId|会员卡ID||false|integer(int64)||
|
|||
|
|
|  vipStartDate|VIP有效期起始||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询用户VIP购买(类似订单)列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/base/listByOrder`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string(date-time)||
|
|||
|
|
|endTime|结束时间|query|false|string(date-time)||
|
|||
|
|
|orderId|主键ID|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|totalAmout|订单金额|query|false|number||
|
|||
|
|
|vipName|会员卡名称|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## VIP卡已退款
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/base/overpassed/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## VIP卡退款
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/base/refund/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户VIP购买详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/base/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除用户VIP购买
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/base/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 统计分析
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询注册用户统计
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/analysis/countRegisteredUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|timeType|timeType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询浏览量统计
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/analysis/countViewNum`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|dataType|query|true|string||
|
|||
|
|
|timeType|timeType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据分类饼图
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/analysis/dataTypePie`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|dataType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/analysis/reserveDetail`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约趋势
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/analysis/reserveTrend`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|timeType|timeType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询浏览量TOP10
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/analysis/viewNumTop`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|dataType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 评论管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量评论审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataComment/approves`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approveStatus": "",
|
|||
|
|
"commentId": []
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCommentApprovalDTO|dataCommentApprovalDTO|body|true|DataCommentApprovalDto|DataCommentApprovalDto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approveStatus|审核操作(0:初始,1:通过,2:驳回)||false|string||
|
|||
|
|
|  commentId|评论ID||false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章订单(场馆)评论详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataComment/detail/{commentId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentId|commentId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 评论管理列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataComment/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentBy|评论人|query|false|string||
|
|||
|
|
|commentContent|评论内容|query|false|string||
|
|||
|
|
|commentStatus|评论状态 0初始,1通过,2不通过|query|false|string||
|
|||
|
|
|dataType|数据类型 4文章,8订单|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|startTime|开始时间|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章和订单评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataComment/noLogin/articleList/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询场馆评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataComment/noLogin/venueList/{venueId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|venueId|venueId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 今日评论通过量,待审核量
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/dataComment/num`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 预约场地配置管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约场地配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBusiness`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admissionNotice": "",
|
|||
|
|
"beginDay": 0,
|
|||
|
|
"beginTime": "",
|
|||
|
|
"businessHourDto": [
|
|||
|
|
{
|
|||
|
|
"hourEnd": "12:00",
|
|||
|
|
"hourPrice": 0,
|
|||
|
|
"hourStart": "08:00"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"businessType": "",
|
|||
|
|
"buyNotice": "",
|
|||
|
|
"closeDate": "2022-03-18,2022-03-19",
|
|||
|
|
"closeTime": "17:00",
|
|||
|
|
"contactName": "",
|
|||
|
|
"contactTel": "",
|
|||
|
|
"dayTicketMax": 0,
|
|||
|
|
"endDate": "2022-03-31",
|
|||
|
|
"fieldIds": "",
|
|||
|
|
"isRefund": "",
|
|||
|
|
"isRefundApproval": "",
|
|||
|
|
"onceTicketMax": 0,
|
|||
|
|
"openTime": "08:00",
|
|||
|
|
"payType": "",
|
|||
|
|
"periodPrice": 0,
|
|||
|
|
"periodPriceType": "",
|
|||
|
|
"refundNotice": "",
|
|||
|
|
"reserveEndTime": "",
|
|||
|
|
"reserveStartTime": "",
|
|||
|
|
"reserveType": "",
|
|||
|
|
"startDate": "2022-03-17",
|
|||
|
|
"ticketPrice": 0,
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymBusinessAddDto|gymBusinessAddDto|body|true|新增预约场地配置Dto|新增预约场地配置Dto|
|
|||
|
|
|  admissionNotice|入场须知||false|string||
|
|||
|
|
|  beginDay|线上开放可预约周期||false|integer(int32)||
|
|||
|
|
|  beginTime|每日开放预约时间||false|string||
|
|||
|
|
|  businessHourDto|按时段定价-可预约时间段列表||false|array|预约场地配置新增及修改经营项目时段Dto|
|
|||
|
|
|    hourEnd|时段结束||false|string||
|
|||
|
|
|    hourPrice|明细价格||false|number||
|
|||
|
|
|    hourStart|时段开始||false|string||
|
|||
|
|
|  businessType|经营项目类型;(1:足球,2:篮球,3:羽毛球,4:网球,5:乒乓球,6:游泳,7:健身,8:桌球,9:拳击,10:击剑,11:其他)||false|string||
|
|||
|
|
|  buyNotice|购买须知||false|string||
|
|||
|
|
|  closeDate|闭馆日期(逗号分隔)||false|string||
|
|||
|
|
|  closeTime|闭馆时间||false|string||
|
|||
|
|
|  contactName|联系人||false|string||
|
|||
|
|
|  contactTel|联系人方式||false|string||
|
|||
|
|
|  dayTicketMax|每日可预订票数||false|integer(int32)||
|
|||
|
|
|  endDate|有效期截止||false|string(date)||
|
|||
|
|
|  fieldIds|场地ID(多选用,隔开)||false|string||
|
|||
|
|
|  isRefund|是否允许退订;(0:否,1:是)||false|string||
|
|||
|
|
|  isRefundApproval|退订是否需审核;(0:否,1:是)||false|string||
|
|||
|
|
|  onceTicketMax|单次限制购票数量||false|integer(int32)||
|
|||
|
|
|  openTime|开馆时间||false|string||
|
|||
|
|
|  payType|付款方式(多选);(1:线上付款,2:线下付款)||false|string||
|
|||
|
|
|  periodPrice|时段单价(时段同价)||false|number||
|
|||
|
|
|  periodPriceType|时段定价类型(1:所有时段同价,2:按时段阶梯定价)||false|string||
|
|||
|
|
|  refundNotice|退订须知||false|string||
|
|||
|
|
|  reserveEndTime|所有时段同价-线上可预约结束时间||false|string||
|
|||
|
|
|  reserveStartTime|所有时段同价-线上可预约开始时间||false|string||
|
|||
|
|
|  reserveType|预约类型(1:按时段包场,2:购票入场)||false|string||
|
|||
|
|
|  startDate|有效期起始||false|string(date)||
|
|||
|
|
|  ticketPrice|门票价格||false|number||
|
|||
|
|
|  venueId|场馆ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改预约场地配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBusiness`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admissionNotice": "",
|
|||
|
|
"beginDay": 0,
|
|||
|
|
"beginTime": "",
|
|||
|
|
"businessHourDto": [
|
|||
|
|
{
|
|||
|
|
"hourEnd": "12:00",
|
|||
|
|
"hourPrice": 0,
|
|||
|
|
"hourStart": "08:00"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"businessId": 0,
|
|||
|
|
"businessType": "",
|
|||
|
|
"buyNotice": "",
|
|||
|
|
"closeDate": "2022-03-18,2022-03-19",
|
|||
|
|
"closeTime": "17:00",
|
|||
|
|
"contactName": "",
|
|||
|
|
"contactTel": "",
|
|||
|
|
"dayTicketMax": 0,
|
|||
|
|
"endDate": "2022-03-31",
|
|||
|
|
"fieldIds": "",
|
|||
|
|
"isRefund": "",
|
|||
|
|
"isRefundApproval": "",
|
|||
|
|
"onceTicketMax": 0,
|
|||
|
|
"openTime": "08:00",
|
|||
|
|
"payType": "",
|
|||
|
|
"periodPrice": 0,
|
|||
|
|
"periodPriceType": "",
|
|||
|
|
"refundNotice": "",
|
|||
|
|
"reserveEndTime": "",
|
|||
|
|
"reserveStartTime": "",
|
|||
|
|
"reserveType": "",
|
|||
|
|
"startDate": "2022-03-17",
|
|||
|
|
"ticketPrice": 0,
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|gymBusinessEditDto|gymBusinessEditDto|body|true|修改预约场地配置Dto|修改预约场地配置Dto|
|
|||
|
|
|  admissionNotice|入场须知||false|string||
|
|||
|
|
|  beginDay|线上开放可预约周期||false|integer(int32)||
|
|||
|
|
|  beginTime|每日开放预约时间||false|string||
|
|||
|
|
|  businessHourDto|按时段定价-可预约时间段列表(注:预约类型为购票入场及按时段阶梯定价时,字段不传)||false|array|预约场地配置新增及修改经营项目时段Dto|
|
|||
|
|
|    hourEnd|时段结束||false|string||
|
|||
|
|
|    hourPrice|明细价格||false|number||
|
|||
|
|
|    hourStart|时段开始||false|string||
|
|||
|
|
|  businessId|经营项目列表ID||true|integer(int64)||
|
|||
|
|
|  businessType|经营项目类型;(1:足球,2:篮球,3:羽毛球,4:网球,5:乒乓球,6:游泳,7:健身,8:桌球,9:拳击,10:击剑,11:其他)||false|string||
|
|||
|
|
|  buyNotice|购买须知(注:预约类型为按时段包场时,字段传null)||false|string||
|
|||
|
|
|  closeDate|闭馆日期(逗号分隔)||false|string||
|
|||
|
|
|  closeTime|闭馆时间||false|string||
|
|||
|
|
|  contactName|联系人||false|string||
|
|||
|
|
|  contactTel|联系人方式||false|string||
|
|||
|
|
|  dayTicketMax|每日可预订票数(注:预约类型为按时段包场时,字段传null)||false|integer(int32)||
|
|||
|
|
|  endDate|有效期截止||false|string(date)||
|
|||
|
|
|  fieldIds|场地ID(多选用,隔开)||false|string||
|
|||
|
|
|  isRefund|是否允许退订;(0:否,1:是)||false|string||
|
|||
|
|
|  isRefundApproval|退订是否需审核;(0:否,1:是)||false|string||
|
|||
|
|
|  onceTicketMax|单次限制购票数量(注:预约类型为按时段包场时,字段传null)||false|integer(int32)||
|
|||
|
|
|  openTime|开馆时间||false|string||
|
|||
|
|
|  payType|付款方式(多选);(1:线上付款,2:线下付款)||false|string||
|
|||
|
|
|  periodPrice|时段单价(时段同价)(注:预约类型为购票入场时,字段传null)||false|number||
|
|||
|
|
|  periodPriceType|时段定价类型(1:所有时段同价,2:按时段阶梯定价)(注:预约类型为购票入场时,字段传null)||false|string||
|
|||
|
|
|  refundNotice|退订须知||false|string||
|
|||
|
|
|  reserveEndTime|所有时段同价-线上可预约结束时间(注:预约类型为购票入场时,字段传null)||false|string||
|
|||
|
|
|  reserveStartTime|所有时段同价-线上可预约开始时间(注:预约类型为购票入场时,字段传null)||false|string||
|
|||
|
|
|  reserveType|预约类型(1:按时段包场,2:购票入场)||false|string||
|
|||
|
|
|  startDate|有效期起始||false|string(date)||
|
|||
|
|
|  ticketPrice|门票价格(注:预约类型为按时段包场时,字段传null)||false|number||
|
|||
|
|
|  venueId|场馆ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询体育馆预约场地配置列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBusiness/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|经营项目;(1:足球,2:篮球,3:羽毛球,4:网球,5:乒乓球,6:游泳,7:健身,8:桌球,9:拳击,10:击剑,11:其他)|query|false|string||
|
|||
|
|
|reserveType|预约类型(1:按时段包场,2:购票入场)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|venueName|所属场馆|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约获取预约场地配置列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBusiness/select/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|经营项目类型|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除预约场地配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBusiness/{businessIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessIds|businessIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取体育馆预约场地配置详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/gymBusiness/{businessId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessId|businessId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 预约要素-前台用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/reserve/addReserve`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"businessId": 0,
|
|||
|
|
"detailAddDtoS": [
|
|||
|
|
{
|
|||
|
|
"detailHour": "",
|
|||
|
|
"detailPrice": 0,
|
|||
|
|
"fieldId": 0,
|
|||
|
|
"reserveDate": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"payType": "",
|
|||
|
|
"reserveNum": 0,
|
|||
|
|
"reserveType": "",
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addDto|addDto|body|true|BaseOnAddDto|BaseOnAddDto|
|
|||
|
|
|  businessId|经营项目ID(根据参数查询得)||false|integer(int64)||
|
|||
|
|
|  detailAddDtoS|预约明细||false|array|DetailAddDto|
|
|||
|
|
|    detailHour|明细时间段||false|string||
|
|||
|
|
|    detailPrice|明细价格||false|number||
|
|||
|
|
|    fieldId|场地ID||false|integer||
|
|||
|
|
|    reserveDate|预约日期||false|string||
|
|||
|
|
|  payType|购票方式{1:线上购买 2:线下购买 3:会员卡}||false|string||
|
|||
|
|
|  reserveNum|预订票数(购票入场)||false|integer(int32)||
|
|||
|
|
|  reserveType|预约类型||false|string||
|
|||
|
|
|  totalAmout|预约单金额||false|number||
|
|||
|
|
|  venueId|场馆ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消退订申请
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/reserve/cancelOptOutApply/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 预约列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/reserve/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createTimeEnd|预约时间止|query|false|string(date-time)||
|
|||
|
|
|createTimeStart|预约时间起|query|false|string(date-time)||
|
|||
|
|
|fieldId|场地id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|reqType|请求类型{0:后台,1:移动端}|query|false|string||
|
|||
|
|
|reserveChannel|预约渠道{2:线上 1:线下}|query|false|string||
|
|||
|
|
|reserveType|预约类型{1:按时段包场 2:购票入场}|query|false|string||
|
|||
|
|
|status|预约单状态{0:待支付 1:待使用 2:待评价 3:已评价 4:退款审核中 5:已退订 6:已驳回 7:已取消}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userPhone|用户手机号|query|false|string||
|
|||
|
|
|venueId|场馆id|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退订申请
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/reserve/optOutApply/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/front/reserve/query/getBaseInfo/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 预约要素-运营后台
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约(线下)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/addReserve`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"businessId": 0,
|
|||
|
|
"businessType": "",
|
|||
|
|
"detailAddDtoS": [
|
|||
|
|
{
|
|||
|
|
"detailHour": "",
|
|||
|
|
"detailPrice": 0,
|
|||
|
|
"fieldId": 0,
|
|||
|
|
"reserveDate": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"detailField": "",
|
|||
|
|
"payType": "",
|
|||
|
|
"reserveNum": 0,
|
|||
|
|
"reserveRemark": "",
|
|||
|
|
"reserveType": "",
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userRealName": "",
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addReserveDto|addReserveDto|body|true|AddReserveDto|AddReserveDto|
|
|||
|
|
|  businessId|经营项目ID(根据参数查询得)||false|integer(int64)||
|
|||
|
|
|  businessType|经营项目类型||false|string||
|
|||
|
|
|  detailAddDtoS|预约明细||false|array|DetailAddDto|
|
|||
|
|
|    detailHour|明细时间段||false|string||
|
|||
|
|
|    detailPrice|明细价格||false|number||
|
|||
|
|
|    fieldId|场地ID||false|integer||
|
|||
|
|
|    reserveDate|预约日期||false|string||
|
|||
|
|
|  detailField|预订场地||false|string||
|
|||
|
|
|  payType|付款方式||false|string||
|
|||
|
|
|  reserveNum|预订票数(购票入场)||false|integer(int32)||
|
|||
|
|
|  reserveRemark|预约备注||false|string||
|
|||
|
|
|  reserveType|预约类型||false|string||
|
|||
|
|
|  totalAmout|预约单金额||false|number||
|
|||
|
|
|  userCardNo|用户身份证号||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userRealName|用户真实姓名||false|string||
|
|||
|
|
|  venueId|场馆ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消预约
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/cancle/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据日期查询余票
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/getTicketNum/{businessId}/{nowDate}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessId|businessId|path|true|integer(int64)||
|
|||
|
|
|nowDate|nowDate|path|true|string(date)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 预约列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createTimeEnd|预约时间止|query|false|string(date-time)||
|
|||
|
|
|createTimeStart|预约时间起|query|false|string(date-time)||
|
|||
|
|
|fieldId|场地id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|reqType|请求类型{0:后台,1:移动端}|query|false|string||
|
|||
|
|
|reserveChannel|预约渠道{2:线上 1:线下}|query|false|string||
|
|||
|
|
|reserveType|预约类型{1:按时段包场 2:购票入场}|query|false|string||
|
|||
|
|
|status|预约单状态{0:待支付 1:待使用 2:待评价 3:已评价 4:退款审核中 5:已退订 6:已驳回 7:已取消}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userPhone|用户手机号|query|false|string||
|
|||
|
|
|venueId|场馆id|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退订
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/optOut`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveIds|reserveIds|query|true|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退订审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/optOutApproval`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addDto|addDto|body|true|新增数据审核Dto|新增数据审核Dto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/query/getBaseInfo/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改预约
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/update`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"businessId": 0,
|
|||
|
|
"businessType": "",
|
|||
|
|
"detailAddDtoS": [
|
|||
|
|
{
|
|||
|
|
"detailHour": "",
|
|||
|
|
"detailPrice": 0,
|
|||
|
|
"fieldId": 0,
|
|||
|
|
"reserveDate": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"detailField": "",
|
|||
|
|
"payType": "",
|
|||
|
|
"reserveNum": 0,
|
|||
|
|
"reserveRemark": "",
|
|||
|
|
"reserveType": "",
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userRealName": "",
|
|||
|
|
"venueId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addReserveDto|addReserveDto|body|true|AddReserveDto|AddReserveDto|
|
|||
|
|
|  businessId|经营项目ID(根据参数查询得)||false|integer(int64)||
|
|||
|
|
|  businessType|经营项目类型||false|string||
|
|||
|
|
|  detailAddDtoS|预约明细||false|array|DetailAddDto|
|
|||
|
|
|    detailHour|明细时间段||false|string||
|
|||
|
|
|    detailPrice|明细价格||false|number||
|
|||
|
|
|    fieldId|场地ID||false|integer||
|
|||
|
|
|    reserveDate|预约日期||false|string||
|
|||
|
|
|  detailField|预订场地||false|string||
|
|||
|
|
|  payType|付款方式||false|string||
|
|||
|
|
|  reserveNum|预订票数(购票入场)||false|integer(int32)||
|
|||
|
|
|  reserveRemark|预约备注||false|string||
|
|||
|
|
|  reserveType|预约类型||false|string||
|
|||
|
|
|  totalAmout|预约单金额||false|number||
|
|||
|
|
|  userCardNo|用户身份证号||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userRealName|用户真实姓名||false|string||
|
|||
|
|
|  venueId|场馆ID||false|integer(int64)||
|
|||
|
|
|reserveId|reserveId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 核销
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/gym/reserve/writeOff/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**简介**:系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**HOST**:xxxx.xxxx.xxxx
|
|||
|
|
|
|||
|
|
|
|||
|
|
**联系人**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Version**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口路径**:/museum/v2/api-docs
|
|||
|
|
|
|||
|
|
|
|||
|
|
[TOC]
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台博物馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询博物馆基础详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumBase/noLogin`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台博物馆展厅
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆展厅列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumHall/noLogin/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|floorId|楼层id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆展厅详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumHall/noLogin/{hallId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|hallId|hallId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台博物馆楼层
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询博物馆楼层列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumFloor/noLogin/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|floorStatus|楼层状态|query|false|string||
|
|||
|
|
|museumId|博物馆Id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台博物馆藏品
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 展厅查询博物馆藏品列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumExhibit/noLogin/listByHall`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|exhibitEra|藏品年代(取config_id)|query|false|integer(int64)||
|
|||
|
|
|exhibitModule|藏品所属模块|query|false|string||
|
|||
|
|
|exhibitName|藏品名称|query|false|string||
|
|||
|
|
|exhibitStatus|展品状态;(0:待审核,1:已上架,2:已下架,4:已驳回,9:草稿)|query|false|array|string|
|
|||
|
|
|exhibitTexture|藏品质地(取config_id)|query|false|integer(int64)||
|
|||
|
|
|exhibitType|藏品分类(取config_id)|query|false|integer(int64)||
|
|||
|
|
|hallId|展厅ID|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆藏品详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumExhibit/noLogin/{exhibitId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitId|exhibitId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台博物馆藏品分类配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询博物馆藏品分类配置列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/exhibitConfig/noLogin/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|configName|配置名称|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台展览活动管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询博物馆展览活动列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumExhibition/noLogin/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取博物馆展览详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumExhibition/noLogin/{exhibitionId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionId|exhibitionId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台收藏管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 添加收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataCollection/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCollectionAddDTO|dataCollectionAddDTO|body|true|添加收藏Dto|添加收藏Dto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|收藏类型 4:藏品,5:文章,6:展览||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataCollection/del/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询收藏列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataCollection/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|collectionBy|收藏人|query|false|string||
|
|||
|
|
|dataName|收藏名称|query|false|string||
|
|||
|
|
|dataType|收藏类型 4:藏品,5:文章,6:展览|query|false|string||
|
|||
|
|
|reqType|请求类型{0:后台,1:前台}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量取消收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataCollection/removes/{collectionIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|collectionIds|collectionIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台文章管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取用户服务协议和隐私政策(contentType 1:用户服务协议,2:隐私政策)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumArticle/noLogin/getAgreementAndPolicy`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|contentType|contentType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取博物馆展馆概况
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumArticle/noLogin/getMuseumSituation`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台查询文章列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumArticle/noLogin/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleModule|所属模块(1:精品文章,2:展馆动态|query|false|string||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 前台获取文章详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/museumArticle/noLogin/{articleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleId|articleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 增加点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/praise/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataPraiseAddDTO|dataPraiseAddDTO|body|true|插入点赞记录|插入点赞记录|
|
|||
|
|
|  dataId|点赞类型id||false|integer(int64)||
|
|||
|
|
|  dataType|点赞类型 4:藏品 5:文章||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 我的点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/praise/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|点赞类型 4:藏品,5:文章|query|false|string||
|
|||
|
|
|praiseBy|点赞人|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除点赞
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/praise/remove/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 前台评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataComment/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"commentBy": "",
|
|||
|
|
"commentContent": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCommentAddDTO|dataCommentAddDTO|body|true|添加评论|添加评论|
|
|||
|
|
|  commentBy|评论人||false|string||
|
|||
|
|
|  commentContent|评论内容||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型 4:藏品,5:文章||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataComment/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"commentContent": "",
|
|||
|
|
"commentId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCommentEditDTO|dataCommentEditDTO|body|true|修改评论|修改评论|
|
|||
|
|
|  commentContent|评论内容||false|string||
|
|||
|
|
|  commentId|评论ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询我的评论列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataComment/myList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentBy|评论者|query|false|string||
|
|||
|
|
|commentStatus|评论状态 0初始,1通过,2不通过|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章藏品评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataComment/noLogin/list/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/dataComment/remove/{commentId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentId|commentId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 博物馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆基础详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumBase`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增博物馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumBase`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"areaCode": "",
|
|||
|
|
"cityCode": "",
|
|||
|
|
"museumAddress": "",
|
|||
|
|
"museumDesc": "",
|
|||
|
|
"museumId": 0,
|
|||
|
|
"museumLogo": "",
|
|||
|
|
"museumName": "",
|
|||
|
|
"payChannel": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"provinceCode": "",
|
|||
|
|
"themeColor": "",
|
|||
|
|
"wechatAccount": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumBaseAddDto|博物馆基础Dto|body|true|MuseumBaseAddDto对象|MuseumBaseAddDto对象|
|
|||
|
|
|  areaCode|区编码||false|string||
|
|||
|
|
|  cityCode|市编码||false|string||
|
|||
|
|
|  museumAddress|博物馆地址||false|string||
|
|||
|
|
|  museumDesc|博物馆简介||false|string||
|
|||
|
|
|  museumId|主键ID||false|integer(int64)||
|
|||
|
|
|  museumLogo|博物馆LOGO||false|string||
|
|||
|
|
|  museumName|博物馆名称||false|string||
|
|||
|
|
|  payChannel|支付渠道||false|string||
|
|||
|
|
|  phone|手机号||false|string||
|
|||
|
|
|  provinceCode|省编码||false|string||
|
|||
|
|
|  themeColor|主题颜色||false|string||
|
|||
|
|
|  wechatAccount|微信账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改博物馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumBase`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"areaCode": "",
|
|||
|
|
"cityCode": "",
|
|||
|
|
"museumAddress": "",
|
|||
|
|
"museumDesc": "",
|
|||
|
|
"museumId": 0,
|
|||
|
|
"museumLogo": "",
|
|||
|
|
"museumName": "",
|
|||
|
|
"payChannel": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"provinceCode": "",
|
|||
|
|
"themeColor": "",
|
|||
|
|
"wechatAccount": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumBaseEditDto|博物馆基础Dto|body|true|MuseumBaseAddDto对象|MuseumBaseAddDto对象|
|
|||
|
|
|  areaCode|区编码||false|string||
|
|||
|
|
|  cityCode|市编码||false|string||
|
|||
|
|
|  museumAddress|博物馆地址||false|string||
|
|||
|
|
|  museumDesc|博物馆简介||false|string||
|
|||
|
|
|  museumId|主键ID||false|integer(int64)||
|
|||
|
|
|  museumLogo|博物馆LOGO||false|string||
|
|||
|
|
|  museumName|博物馆名称||false|string||
|
|||
|
|
|  payChannel|支付渠道||false|string||
|
|||
|
|
|  phone|手机号||false|string||
|
|||
|
|
|  provinceCode|省编码||false|string||
|
|||
|
|
|  themeColor|主题颜色||false|string||
|
|||
|
|
|  wechatAccount|微信账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取行政区域
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumBase/getAddress`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|parentCode|父地区编码|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆基础列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumBase/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除博物馆基础
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumBase/{museumId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumId|museumId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 博物馆展厅
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增博物馆展厅
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumHall`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"floorId": 0,
|
|||
|
|
"hallArea": 0,
|
|||
|
|
"hallDesc": "",
|
|||
|
|
"hallName": "",
|
|||
|
|
"recommendExhibitList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumHallAddDto|博物馆展厅Dto|body|true|MuseumHallAddDto对象|MuseumHallAddDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileList|文件List||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  floorId|楼层Id||false|integer(int64)||
|
|||
|
|
|  hallArea|展厅面积||false|integer(int32)||
|
|||
|
|
|  hallDesc|展厅描述||false|string||
|
|||
|
|
|  hallName|展厅名称||false|string||
|
|||
|
|
|  recommendExhibitList|推荐展品List||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改博物馆展厅
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumHall`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"hallArea": 0,
|
|||
|
|
"hallDesc": "",
|
|||
|
|
"hallId": 0,
|
|||
|
|
"hallName": "",
|
|||
|
|
"hallStatus": "",
|
|||
|
|
"recommendExhibitList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumHallEditDto|博物馆展厅Dto|body|true|MuseumHallEditDto对象|MuseumHallEditDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileList|文件List||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  hallArea|展厅面积||false|integer(int32)||
|
|||
|
|
|  hallDesc|展厅描述||false|string||
|
|||
|
|
|  hallId|主键ID||false|integer(int64)||
|
|||
|
|
|  hallName|展厅名称||false|string||
|
|||
|
|
|  hallStatus|展厅状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|  recommendExhibitList|推荐展品List||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 展厅启用与停用
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumHall/hallStatus`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"hallId": 0,
|
|||
|
|
"hallStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumHallStatusDto|博物馆展厅Dto|body|true|MuseumHallStatusDto对象|MuseumHallStatusDto对象|
|
|||
|
|
|  hallId|展厅主键ID||false|integer(int64)||
|
|||
|
|
|  hallStatus|展厅状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆展厅列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumHall/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|floorId|楼层id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆展厅详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumHall/{hallId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|hallId|hallId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除博物馆展厅
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumHall/{hallId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|hallId|hallId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 博物馆楼层
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增博物馆楼层
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFloor`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"floorArea": 0,
|
|||
|
|
"floorDesc": "",
|
|||
|
|
"floorName": "",
|
|||
|
|
"museumId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFloorAddDto|博物馆楼层Dto|body|true|MuseumFloorAddDto对象|MuseumFloorAddDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileList|文件List||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  floorArea|楼层面积||false|integer(int32)||
|
|||
|
|
|  floorDesc|楼层描述||false|string||
|
|||
|
|
|  floorName|楼层名称||false|string||
|
|||
|
|
|  museumId|博物馆Id||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改博物馆楼层
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFloor`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"floorArea": 0,
|
|||
|
|
"floorDesc": "",
|
|||
|
|
"floorId": 0,
|
|||
|
|
"floorName": "",
|
|||
|
|
"floorStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFloorEditDto|博物馆楼层Dto|body|true|MuseumFloorEditDto对象|MuseumFloorEditDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileList|文件List||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  floorArea|楼层面积||false|integer(int32)||
|
|||
|
|
|  floorDesc|楼层描述||false|string||
|
|||
|
|
|  floorId|主键ID||false|integer(int64)||
|
|||
|
|
|  floorName|楼层名称||false|string||
|
|||
|
|
|  floorStatus|楼层状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 楼层启用与停用
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFloor/floorStatus`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"floorId": 0,
|
|||
|
|
"floorStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFloorStatusDto|博物馆楼层Dto|body|true|MuseumFloorStatusDto对象|MuseumFloorStatusDto对象|
|
|||
|
|
|  floorId|楼层主键ID||false|integer(int64)||
|
|||
|
|
|  floorStatus|楼层状态;(0:停用,1:开放)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆楼层列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFloor/listByUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|floorStatus|楼层状态|query|false|string||
|
|||
|
|
|museumId|博物馆Id|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆楼层详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFloor/{floorId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|floorId|floorId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除博物馆楼层
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFloor/{floorId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|floorId|floorId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 博物馆藏品
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增博物馆藏品
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"exhibitDesc": "",
|
|||
|
|
"exhibitEra": 0,
|
|||
|
|
"exhibitExtend": "",
|
|||
|
|
"exhibitModule": "",
|
|||
|
|
"exhibitName": "",
|
|||
|
|
"exhibitNo": "",
|
|||
|
|
"exhibitSummary": "",
|
|||
|
|
"exhibitTexture": 0,
|
|||
|
|
"exhibitType": 0,
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"hallId": 0,
|
|||
|
|
"isComment": "",
|
|||
|
|
"isPraise": "",
|
|||
|
|
"isTop": "",
|
|||
|
|
"recommendThing": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"saveOrSubmit": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumExhibitAddDto|博物馆藏品Dto|body|true|MuseumExhibitAddDto对象|MuseumExhibitAddDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  exhibitDesc|藏品详情||false|string||
|
|||
|
|
|  exhibitEra|藏品年代(取config_id)||false|integer(int64)||
|
|||
|
|
|  exhibitExtend|藏品扩展阅读||false|string||
|
|||
|
|
|  exhibitModule|藏品所属模块||false|string||
|
|||
|
|
|  exhibitName|藏品名称||false|string||
|
|||
|
|
|  exhibitNo|藏品编号||false|string||
|
|||
|
|
|  exhibitSummary|藏品简介||false|string||
|
|||
|
|
|  exhibitTexture|藏品质地(取config_id)||false|integer(int64)||
|
|||
|
|
|  exhibitType|藏品分类(取config_id)||false|integer(int64)||
|
|||
|
|
|  fileList|文件List||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  hallId|展厅ID||false|integer(int64)||
|
|||
|
|
|  isComment|是否允许评论;(0:否,1:是)||false|string||
|
|||
|
|
|  isPraise|是否允许点赞;(0:否,1:是)||false|string||
|
|||
|
|
|  isTop|是否置顶;(0:否,1:是)||false|string||
|
|||
|
|
|  recommendThing|推荐内容List||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  saveOrSubmit|操作(1:保存,2:提交)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改博物馆藏品
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"exhibitDesc": "",
|
|||
|
|
"exhibitEra": 0,
|
|||
|
|
"exhibitExtend": "",
|
|||
|
|
"exhibitId": 0,
|
|||
|
|
"exhibitModule": "",
|
|||
|
|
"exhibitName": "",
|
|||
|
|
"exhibitNo": "",
|
|||
|
|
"exhibitStatus": "",
|
|||
|
|
"exhibitSummary": "",
|
|||
|
|
"exhibitTexture": 0,
|
|||
|
|
"exhibitType": 0,
|
|||
|
|
"fileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"hallId": 0,
|
|||
|
|
"isComment": "",
|
|||
|
|
"isPraise": "",
|
|||
|
|
"isTop": "",
|
|||
|
|
"recommendThing": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"saveOrSubmit": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumExhibitEditDto|博物馆藏品Dto|body|true|MuseumExhibitEditDto对象|MuseumExhibitEditDto对象|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  exhibitDesc|藏品详情||false|string||
|
|||
|
|
|  exhibitEra|藏品年代(取config_id)||false|integer(int64)||
|
|||
|
|
|  exhibitExtend|藏品扩展阅读||false|string||
|
|||
|
|
|  exhibitId|主键ID||false|integer(int64)||
|
|||
|
|
|  exhibitModule|藏品所属模块||false|string||
|
|||
|
|
|  exhibitName|藏品名称||false|string||
|
|||
|
|
|  exhibitNo|藏品编号||false|string||
|
|||
|
|
|  exhibitStatus|藏品状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  exhibitSummary|藏品简介||false|string||
|
|||
|
|
|  exhibitTexture|藏品质地(取config_id)||false|integer(int64)||
|
|||
|
|
|  exhibitType|藏品分类(取config_id)||false|integer(int64)||
|
|||
|
|
|  fileList|文件List||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  hallId|展厅ID||false|integer(int64)||
|
|||
|
|
|  isComment|是否允许评论;(0:否,1:是)||false|string||
|
|||
|
|
|  isPraise|是否允许点赞;(0:否,1:是)||false|string||
|
|||
|
|
|  isTop|是否置顶;(0:否,1:是)||false|string||
|
|||
|
|
|  recommendThing|推荐内容List||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  saveOrSubmit|操作(1:保存,2:提交)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 藏品审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit/approve`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approveOpinion": "",
|
|||
|
|
"approveStatus": "",
|
|||
|
|
"exhibitId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumExhibitApproveDto|museumExhibitApproveDto|body|true|展品审核Dto|展品审核Dto|
|
|||
|
|
|  approveOpinion|审核意见||false|string||
|
|||
|
|
|  approveStatus|审核操作(1:通过,2:驳回)||true|string||
|
|||
|
|
|  exhibitId|展品ID||true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆藏品列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit/listByHall`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|exhibitEra|藏品年代(取config_id)|query|false|integer(int64)||
|
|||
|
|
|exhibitModule|藏品所属模块|query|false|string||
|
|||
|
|
|exhibitName|藏品名称|query|false|string||
|
|||
|
|
|exhibitStatus|展品状态;(0:待审核,1:已上架,2:已下架,4:已驳回,9:草稿)|query|false|array|string|
|
|||
|
|
|exhibitTexture|藏品质地(取config_id)|query|false|integer(int64)||
|
|||
|
|
|exhibitType|藏品分类(取config_id)|query|false|integer(int64)||
|
|||
|
|
|hallId|展厅ID|query|false|integer(int64)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 展品下架
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit/offline/{exhibitId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitId|exhibitId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 展品置顶与取消置顶
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit/toTop`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"exhibitId": 0,
|
|||
|
|
"isTop": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumExhibitToTopDto|museumExhibitToTopDto|body|true|展品置顶与取消Dto|展品置顶与取消Dto|
|
|||
|
|
|  exhibitId|展品ID||true|integer(int64)||
|
|||
|
|
|  isTop|置顶操作(1:置顶,2:取消置顶)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆藏品详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit/{exhibitId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitId|exhibitId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除博物馆藏品
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibit/{exhibitId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitId|exhibitId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 博物馆藏品分类配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增博物馆藏品分类配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/config`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"configLevel": 0,
|
|||
|
|
"configName": "",
|
|||
|
|
"configType": "",
|
|||
|
|
"parentId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitConfigAddDto|藏品分类配置Dto|body|true|ExhibitConfigAddDto对象|ExhibitConfigAddDto对象|
|
|||
|
|
|  configLevel|配置级别||false|integer(int32)||
|
|||
|
|
|  configName|配置名称||false|string||
|
|||
|
|
|  configType|配置类型(1.分类,2.质地,3.年代)||false|string||
|
|||
|
|
|  parentId|父类ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改博物馆藏品分类配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/config`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"configId": 0,
|
|||
|
|
"configLevel": 0,
|
|||
|
|
"configName": "",
|
|||
|
|
"configType": "",
|
|||
|
|
"parentId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitConfigEditDto|藏品分类配置Dto|body|true|ExhibitConfigEditDto对象|ExhibitConfigEditDto对象|
|
|||
|
|
|  configId|主键Id||false|integer(int64)||
|
|||
|
|
|  configLevel|配置级别||false|integer(int32)||
|
|||
|
|
|  configName|配置名称||false|string||
|
|||
|
|
|  configType|配置类型||false|string||
|
|||
|
|
|  parentId|父类ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆藏品分类配置列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/config/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|开始时间|query|false|string||
|
|||
|
|
|configName|配置名称|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆藏品分类配置详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/config/{configId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configId|configId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除博物馆藏品分类配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/config/{configId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configId|configId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 多媒体文件管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增多媒体文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileDesc": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileType": 1,
|
|||
|
|
"fileUrl": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFileAddDto|museumFileAddDto|body|true|新增多媒体文件Dto|新增多媒体文件Dto|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileDesc|文件简介||true|string||
|
|||
|
|
|  fileName|文件名称||true|string||
|
|||
|
|
|  fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  fileUrl|文件路径(相对)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改多媒体文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"fileDesc": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumFileEditDto|museumFileEditDto|body|true|修改多媒体文件Dto|修改多媒体文件Dto|
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  fileDesc|文件简介||false|string||
|
|||
|
|
|  fileId|文件ID||true|integer(int64)||
|
|||
|
|
|  fileName|文件名称||false|string||
|
|||
|
|
|  fileUrl|文件路径(相对)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出多媒体文件列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|操作开始时间|query|false|string(date)||
|
|||
|
|
|endTime|操作结束时间|query|false|string(date)||
|
|||
|
|
|fileName|文件名称|query|false|string||
|
|||
|
|
|fileType|文件类型(1:图片,2:视频,3:音频,4:模型)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 判断文件是否已经存在
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile/isExist`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileName|文件名称|query|true|string||
|
|||
|
|
|fileType|文件类型(1:图片,2:视频,3:音频,4:模型)|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 判断文件是否被引用
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile/isQuote/{fileIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileIds|fileIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询多媒体文件列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|beginTime|操作开始时间|query|false|string(date)||
|
|||
|
|
|endTime|操作结束时间|query|false|string(date)||
|
|||
|
|
|fileName|文件名称|query|false|string||
|
|||
|
|
|fileType|文件类型(1:图片,2:视频,3:音频,4:模型)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除多媒体文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile/{fileIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileIds|fileIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取多媒体文件详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumFile/{fileId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|fileId|fileId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 展览活动配置管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增展览
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"beginDay": 0,
|
|||
|
|
"beginTime": "08:00",
|
|||
|
|
"closeDate": "",
|
|||
|
|
"closeTime": "17:00",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"endDate": "",
|
|||
|
|
"exhibitionAddress": "",
|
|||
|
|
"exhibitionName": "",
|
|||
|
|
"isPay": "",
|
|||
|
|
"openTime": "08:00",
|
|||
|
|
"payType": "",
|
|||
|
|
"refundRule": "",
|
|||
|
|
"relDataList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"startDate": "",
|
|||
|
|
"ticketChildren": 0,
|
|||
|
|
"ticketDiscount": 0,
|
|||
|
|
"ticketPrice": 0,
|
|||
|
|
"touristMax": 0,
|
|||
|
|
"visitNotice": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumExhibitionAddDto|museumExhibitionAddDto|body|true|新增展览活动Dto|新增展览活动Dto|
|
|||
|
|
|  beginDay|线上开放可预约周期||false|integer(int32)||
|
|||
|
|
|  beginTime|每日开放预约时间||false|string||
|
|||
|
|
|  closeDate|闭馆日期(逗号分隔)||false|string||
|
|||
|
|
|  closeTime|闭馆时间||false|string||
|
|||
|
|
|  coverFile|封面文件||false|楼层、展厅、藏品、文章、视频、模型封面文件新增及修改Dto|楼层、展厅、藏品、文章、视频、模型封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  endDate|有效期截止||false|string(date)||
|
|||
|
|
|  exhibitionAddress|展览地址||false|string||
|
|||
|
|
|  exhibitionName|展览名称||false|string||
|
|||
|
|
|  isPay|是否购票;(0:否,1:是)||false|string||
|
|||
|
|
|  openTime|开馆时间||false|string||
|
|||
|
|
|  payType|购票方式(多选);(1:线上购买,2:现场购买)||false|string||
|
|||
|
|
|  refundRule|退票规则||false|string||
|
|||
|
|
|  relDataList|推荐内容列表||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  startDate|有效期起始||false|string(date)||
|
|||
|
|
|  ticketChildren|儿童票价格||false|number||
|
|||
|
|
|  ticketDiscount|优惠门票价格||false|number||
|
|||
|
|
|  ticketPrice|门票价格||false|number||
|
|||
|
|
|  touristMax|游客上限(每日)||false|integer(int32)||
|
|||
|
|
|  visitNotice|参观须知||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改展览
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"beginDay": 0,
|
|||
|
|
"beginTime": "08:00",
|
|||
|
|
"closeDate": "",
|
|||
|
|
"closeTime": "17:00",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"endDate": "",
|
|||
|
|
"exhibitionAddress": "",
|
|||
|
|
"exhibitionId": 0,
|
|||
|
|
"exhibitionName": "",
|
|||
|
|
"isPay": "",
|
|||
|
|
"openTime": "08:00",
|
|||
|
|
"payType": "",
|
|||
|
|
"refundRule": "",
|
|||
|
|
"relDataList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"startDate": "",
|
|||
|
|
"ticketChildren": 0,
|
|||
|
|
"ticketDiscount": 0,
|
|||
|
|
"ticketPrice": 0,
|
|||
|
|
"touristMax": 0,
|
|||
|
|
"visitNotice": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumExhibitionEditDto|museumExhibitionEditDto|body|true|修改展览Dto|修改展览Dto|
|
|||
|
|
|  beginDay|线上开放可预约周期||false|integer(int32)||
|
|||
|
|
|  beginTime|每日开放预约时间||false|string||
|
|||
|
|
|  closeDate|闭馆日期(逗号分隔)||false|string||
|
|||
|
|
|  closeTime|闭馆时间||false|string||
|
|||
|
|
|  coverFile|封面文件||false|楼层、展厅、藏品、文章、视频、模型封面文件新增及修改Dto|楼层、展厅、藏品、文章、视频、模型封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  endDate|有效期截止||false|string(date)||
|
|||
|
|
|  exhibitionAddress|展览地址||false|string||
|
|||
|
|
|  exhibitionId|展览ID||true|integer(int64)||
|
|||
|
|
|  exhibitionName|展览名称||false|string||
|
|||
|
|
|  isPay|是否购票;(0:否,1:是)||false|string||
|
|||
|
|
|  openTime|开馆时间||false|string||
|
|||
|
|
|  payType|购票方式(多选);(1:线上购买,2:现场购买)||false|string||
|
|||
|
|
|  refundRule|退票规则||false|string||
|
|||
|
|
|  relDataList|推荐内容列表||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  startDate|有效期起始||false|string(date)||
|
|||
|
|
|  ticketChildren|儿童票价格||false|number||
|
|||
|
|
|  ticketDiscount|优惠门票价格||false|number||
|
|||
|
|
|  ticketPrice|门票价格||false|number||
|
|||
|
|
|  touristMax|游客上限(每日)||false|integer(int32)||
|
|||
|
|
|  visitNotice|参观须知||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出博物馆展览查询列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionName|展览配置名称|query|false|string||
|
|||
|
|
|isPay|是否购票;(0:否,1:是)|query|false|string||
|
|||
|
|
|openOrderBeginTime|开放预约开始时间|query|false|string(date)||
|
|||
|
|
|openOrderEndTime|开放预约结束时间|query|false|string(date)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取周期性闭馆日期
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition/getCloseDate`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|closeDateArray|具体哪天(每周 就传1-7 每月 就传1-31 多选用逗号隔开)|query|true|array|integer|
|
|||
|
|
|cycleType|闭馆周期类型(1:每周,2:每月)|query|true|string||
|
|||
|
|
|endDate|有效期截止|query|true|string(date)||
|
|||
|
|
|startDate|有效期起始|query|true|string(date)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询博物馆展览活动列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionName|展览配置名称|query|false|string||
|
|||
|
|
|isPay|是否购票;(0:否,1:是)|query|false|string||
|
|||
|
|
|openOrderBeginTime|开放预约开始时间|query|false|string(date)||
|
|||
|
|
|openOrderEndTime|开放预约结束时间|query|false|string(date)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约获取展览活动列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition/select/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除展览
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition/{exhibitionIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionIds|exhibitionIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取博物馆展览详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumExhibition/{exhibitionId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionId|exhibitionId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 推送记录
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量删除推送数据
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/message/userList/deletes`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ids|ids|query|false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取推送数据详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/message/userList/info`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|activeStatus||query|false|string||
|
|||
|
|
|articleName|文章名称(100)|query|false|string||
|
|||
|
|
|createEnd|注册时间 :结束日期(10)|query|false|string||
|
|||
|
|
|createStart|注册时间 :开始日期(10)|query|false|string||
|
|||
|
|
|dataType|数据类型: 4:藏品 5:文章 6:展览|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|exhibitType|藏品类型(10)|query|false|string||
|
|||
|
|
|exhibitionName|展览名称(100)|query|false|string||
|
|||
|
|
|pushId|pushId|query|false|integer(int64)||
|
|||
|
|
|pushTag|推送标签|query|false|string||
|
|||
|
|
|reserveType|预约类型(10)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userAddress||query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取推送数据记录列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/message/userList/recordList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|数据类型|query|false|string||
|
|||
|
|
|pushStatus|推送状态,0:未推送,1:已推送|query|false|string||
|
|||
|
|
|pushTimeEnd|推送时间止|query|false|string(date-time)||
|
|||
|
|
|pushTimeStart|推送时间起|query|false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除推送数据
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/message/userList/update`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|pushId|pushId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 支付相关
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 支付信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userPay/getPay/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 支付结果通知(应为第三方回调接口,接入后修改)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userPay/payCallBack/{orderId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderId|orderId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 去支付
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userPay/toPay`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"orderId": 0,
|
|||
|
|
"orderType": "",
|
|||
|
|
"payAmout": 0,
|
|||
|
|
"payChannel": "",
|
|||
|
|
"payMethod": "",
|
|||
|
|
"payType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addDto|addDto|body|true|UserPayAddDto|UserPayAddDto|
|
|||
|
|
|  orderId|订单ID||false|integer(int64)||
|
|||
|
|
|  orderType|订单类型||false|string||
|
|||
|
|
|  payAmout|支付金额||false|number||
|
|||
|
|
|  payChannel|支付渠道||false|string||
|
|||
|
|
|  payMethod|支付方式||false|string||
|
|||
|
|
|  payType|支付类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增保存数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|DataApprovalAddDto|DataApprovalAddDto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量新增数据审核(批量审核)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/adds`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dtos|dtos|body|true|array|DataApprovalAddDto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|DataApprovalAddDto|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|approvalDesc|审核描述|string||
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|dataId|数据ID|integer(int64)|integer(int64)|
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|DataApprovalEditDto|DataApprovalEditDto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalId|审批ID||false|integer(int64)||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量修改数据审核(批量审核)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/edits`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dtos|dtos|body|true|array|DataApprovalEditDto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalId|审批ID||false|integer(int64)||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|DataApprovalEditDto|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|approvalDesc|审核描述|string||
|
|||
|
|
|approvalId|审批ID|integer(int64)|integer(int64)|
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据审核列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|approvalEnd|结束时间:审核时间|query|false|string||
|
|||
|
|
|approvalStart|开始时间:审核时间|query|false|string||
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|query|false|string||
|
|||
|
|
|dataType|数据类型|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|PageInfo«数据审核列表Vo»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|endRow||integer(int64)|integer(int64)|
|
|||
|
|
|hasNextPage||boolean||
|
|||
|
|
|hasPreviousPage||boolean||
|
|||
|
|
|isFirstPage||boolean||
|
|||
|
|
|isLastPage||boolean||
|
|||
|
|
|list||array|数据审核列表Vo|
|
|||
|
|
|  approvalBy|审核者|string||
|
|||
|
|
|  approvalDesc|审核描述|string||
|
|||
|
|
|  approvalId|审批ID|integer(int64)||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|  approvalTime|审核时间|string(date-time)||
|
|||
|
|
|  dataId|数据ID|integer(int64)||
|
|||
|
|
|  dataType|数据类型|string||
|
|||
|
|
|  delFlag|删除标识;(0:未删除,1:已删除)|string||
|
|||
|
|
|  isCurr|是否最新审核记录;(0:否,1:是)|string||
|
|||
|
|
|  tenantId|租户ID|integer(int64)||
|
|||
|
|
|navigateFirstPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigateLastPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigatePages||integer(int32)|integer(int32)|
|
|||
|
|
|navigatepageNums||array||
|
|||
|
|
|nextPage||integer(int32)|integer(int32)|
|
|||
|
|
|pageNum||integer(int32)|integer(int32)|
|
|||
|
|
|pageSize||integer(int32)|integer(int32)|
|
|||
|
|
|pages||integer(int32)|integer(int32)|
|
|||
|
|
|prePage||integer(int32)|integer(int32)|
|
|||
|
|
|size||integer(int32)|integer(int32)|
|
|||
|
|
|startRow||integer(int64)|integer(int64)|
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"endRow": 0,
|
|||
|
|
"hasNextPage": true,
|
|||
|
|
"hasPreviousPage": true,
|
|||
|
|
"isFirstPage": true,
|
|||
|
|
"isLastPage": true,
|
|||
|
|
"list": [
|
|||
|
|
{
|
|||
|
|
"approvalBy": "",
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"approvalTime": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"isCurr": "",
|
|||
|
|
"tenantId": 0
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"navigateFirstPage": 0,
|
|||
|
|
"navigateLastPage": 0,
|
|||
|
|
"navigatePages": 0,
|
|||
|
|
"navigatepageNums": [],
|
|||
|
|
"nextPage": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"pages": 0,
|
|||
|
|
"prePage": 0,
|
|||
|
|
"size": 0,
|
|||
|
|
"startRow": 0,
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据审核详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/{approvalId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|approvalId|approvalId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|DataApprovalDetailsVo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|approvalBy|审核者|string||
|
|||
|
|
|approvalDesc|审核描述|string||
|
|||
|
|
|approvalId|审批ID|integer(int64)|integer(int64)|
|
|||
|
|
|approvalStatus|审核状态;(0:初始,1:通过,2:不通过)|string||
|
|||
|
|
|approvalTime|审核时间|string(date-time)|string(date-time)|
|
|||
|
|
|dataId|数据ID|integer(int64)|integer(int64)|
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|delFlag|删除标识;(0:未删除,1:已删除)|string||
|
|||
|
|
|tenantId|租户ID|integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalBy": "",
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalId": 0,
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"approvalTime": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"tenantId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除数据审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataApproval/{approvalId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|approvalId|approvalId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 数据推荐关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增保存数据推荐关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataRecommendRel/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|DataRecommendRelAddDto|DataRecommendRelAddDto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  recommendId|推荐数据ID||false|integer(int64)||
|
|||
|
|
|  recommendType|推荐数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据推荐关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataRecommendRel/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": "",
|
|||
|
|
"relId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|DataRecommendRelEditDto|DataRecommendRelEditDto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  recommendId|推荐数据ID||false|integer(int64)||
|
|||
|
|
|  recommendType|推荐数据类型||false|string||
|
|||
|
|
|  relId|关联ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据数据类型获取数据名称列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataRecommendRel/getRecommendDataList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|数据类型(3:展厅,4:藏品,5:文章,6:展览,12:视频)|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据推荐关联列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataRecommendRel/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createEnd|结束时间 :开始日期 yyyy-MM-dd HH:mm:ss|query|false|string||
|
|||
|
|
|createStart|开始时间 :开始日期 yyyy-MM-dd HH:mm:ss|query|false|string||
|
|||
|
|
|dataType|数据类型|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|PageInfo«DataRecommendRelVoList»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|endRow||integer(int64)|integer(int64)|
|
|||
|
|
|hasNextPage||boolean||
|
|||
|
|
|hasPreviousPage||boolean||
|
|||
|
|
|isFirstPage||boolean||
|
|||
|
|
|isLastPage||boolean||
|
|||
|
|
|list||array|DataRecommendRelVoList|
|
|||
|
|
|  createBy|创建者|string||
|
|||
|
|
|  createTime|创建时间|string(date-time)||
|
|||
|
|
|  dataId|数据ID|integer(int64)||
|
|||
|
|
|  dataType|数据类型|string||
|
|||
|
|
|  delFlag|删除标志;(0:未删除,1:已删除)|string||
|
|||
|
|
|  recommendId|推荐数据ID|integer(int64)||
|
|||
|
|
|  recommendType|推荐数据类型|string||
|
|||
|
|
|  relId|关联ID|integer(int64)||
|
|||
|
|
|  tenantId|租户ID|integer(int64)||
|
|||
|
|
|navigateFirstPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigateLastPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigatePages||integer(int32)|integer(int32)|
|
|||
|
|
|navigatepageNums||array||
|
|||
|
|
|nextPage||integer(int32)|integer(int32)|
|
|||
|
|
|pageNum||integer(int32)|integer(int32)|
|
|||
|
|
|pageSize||integer(int32)|integer(int32)|
|
|||
|
|
|pages||integer(int32)|integer(int32)|
|
|||
|
|
|prePage||integer(int32)|integer(int32)|
|
|||
|
|
|size||integer(int32)|integer(int32)|
|
|||
|
|
|startRow||integer(int64)|integer(int64)|
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"endRow": 0,
|
|||
|
|
"hasNextPage": true,
|
|||
|
|
"hasPreviousPage": true,
|
|||
|
|
"isFirstPage": true,
|
|||
|
|
"isLastPage": true,
|
|||
|
|
"list": [
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": "",
|
|||
|
|
"relId": 0,
|
|||
|
|
"tenantId": 0
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"navigateFirstPage": 0,
|
|||
|
|
"navigateLastPage": 0,
|
|||
|
|
"navigatePages": 0,
|
|||
|
|
"navigatepageNums": [],
|
|||
|
|
"nextPage": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"pages": 0,
|
|||
|
|
"prePage": 0,
|
|||
|
|
"size": 0,
|
|||
|
|
"startRow": 0,
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据文件关联详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataRecommendRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|DataRecommendRelDetailsVo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|createBy|创建者|string||
|
|||
|
|
|createTime|创建时间|string(date-time)|string(date-time)|
|
|||
|
|
|dataId|数据ID|integer(int64)|integer(int64)|
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|delFlag|删除标志;(0:未删除,1:已删除)|string||
|
|||
|
|
|recommendId|推荐数据ID|integer(int64)|integer(int64)|
|
|||
|
|
|recommendType|推荐数据类型|string||
|
|||
|
|
|relId|关联ID|integer(int64)|integer(int64)|
|
|||
|
|
|tenantId|租户ID|integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": "",
|
|||
|
|
"relId": 0,
|
|||
|
|
"tenantId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataRecommendRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增保存数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataFileRel/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|DataFileRelAddDto|DataFileRelAddDto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  fileId|文件ID||false|integer(int64)||
|
|||
|
|
|  fileType|文件类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataFileRel/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": "",
|
|||
|
|
"relId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|DataFileRelEditDto|DataFileRelEditDto|
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|  fileId|文件ID||false|integer(int64)||
|
|||
|
|
|  fileType|文件类型||false|string||
|
|||
|
|
|  relId|关联ID||false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据文件关联列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataFileRel/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|query|false|integer(int64)||
|
|||
|
|
|fileType|fileType|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|PageInfo«关联文件详情Vo»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|endRow||integer(int64)|integer(int64)|
|
|||
|
|
|hasNextPage||boolean||
|
|||
|
|
|hasPreviousPage||boolean||
|
|||
|
|
|isFirstPage||boolean||
|
|||
|
|
|isLastPage||boolean||
|
|||
|
|
|list||array|关联文件详情Vo|
|
|||
|
|
|  fileDesc|关联文件简介|string||
|
|||
|
|
|  fileId|关联文件ID|string||
|
|||
|
|
|  fileName|关联文件名称|string||
|
|||
|
|
|  fileType|关联文件类型(1:图片,2:视频,3:音频,4:模型)|string||
|
|||
|
|
|  fileUrl|关联文件路径|string||
|
|||
|
|
|  videoAndModelFileCover|视频、模型文件封面|封面文件详情Vo|封面文件详情Vo|
|
|||
|
|
|    fileId|封面文件ID|string||
|
|||
|
|
|    fileName|封面文件名称|string||
|
|||
|
|
|    fileUrl|封面文件路径|string||
|
|||
|
|
|navigateFirstPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigateLastPage||integer(int32)|integer(int32)|
|
|||
|
|
|navigatePages||integer(int32)|integer(int32)|
|
|||
|
|
|navigatepageNums||array||
|
|||
|
|
|nextPage||integer(int32)|integer(int32)|
|
|||
|
|
|pageNum||integer(int32)|integer(int32)|
|
|||
|
|
|pageSize||integer(int32)|integer(int32)|
|
|||
|
|
|pages||integer(int32)|integer(int32)|
|
|||
|
|
|prePage||integer(int32)|integer(int32)|
|
|||
|
|
|size||integer(int32)|integer(int32)|
|
|||
|
|
|startRow||integer(int64)|integer(int64)|
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"endRow": 0,
|
|||
|
|
"hasNextPage": true,
|
|||
|
|
"hasPreviousPage": true,
|
|||
|
|
"isFirstPage": true,
|
|||
|
|
"isLastPage": true,
|
|||
|
|
"list": [
|
|||
|
|
{
|
|||
|
|
"fileDesc": "",
|
|||
|
|
"fileId": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileType": 1,
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"videoAndModelFileCover": {
|
|||
|
|
"fileId": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": ""
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"navigateFirstPage": 0,
|
|||
|
|
"navigateLastPage": 0,
|
|||
|
|
"navigatePages": 0,
|
|||
|
|
"navigatepageNums": [],
|
|||
|
|
"nextPage": 0,
|
|||
|
|
"pageNum": 0,
|
|||
|
|
"pageSize": 0,
|
|||
|
|
"pages": 0,
|
|||
|
|
"prePage": 0,
|
|||
|
|
"size": 0,
|
|||
|
|
"startRow": 0,
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据文件关联详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataFileRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|DataFileRelDetailsVo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|createBy|创建者|string||
|
|||
|
|
|createTime|创建时间|string(date-time)|string(date-time)|
|
|||
|
|
|dataId|数据ID|integer(int64)|integer(int64)|
|
|||
|
|
|dataType|数据类型|string||
|
|||
|
|
|delFlag|删除标志;(0:未删除,1:已删除)|string||
|
|||
|
|
|fileId|文件ID|integer(int64)|integer(int64)|
|
|||
|
|
|fileName|文件名称|string||
|
|||
|
|
|fileType|文件类型|string||
|
|||
|
|
|relId|关联ID|integer(int64)|integer(int64)|
|
|||
|
|
|tenantId|租户ID|integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileType": "",
|
|||
|
|
"relId": 0,
|
|||
|
|
"tenantId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除数据文件关联
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataFileRel/{relId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|relId|relId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 文章管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增文章
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"articleContent": "",
|
|||
|
|
"articleDesc": "",
|
|||
|
|
"articleModule": 1,
|
|||
|
|
"articleName": "",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"isComment": 1,
|
|||
|
|
"isPraise": 1,
|
|||
|
|
"isTop": 0,
|
|||
|
|
"relDataList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"relFileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"saveOrSubmit": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumArticleAddDto|museumArticleAddDto|body|true|新增文章Dto|新增文章Dto|
|
|||
|
|
|  articleContent|文章内容||false|string||
|
|||
|
|
|  articleDesc|文章简介||false|string||
|
|||
|
|
|  articleModule|所属模块(1:展馆动态,2:精品文章,3:展馆概况,4:用户服务协议,5:隐私政策)||false|string||
|
|||
|
|
|  articleName|文章名称||false|string||
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  isComment|是否允许评论;(0:否,1:是)||false|string||
|
|||
|
|
|  isPraise|是否允许点赞;(0:否,1:是)||false|string||
|
|||
|
|
|  isTop|是否置顶;(0:否,1:是)||false|string||
|
|||
|
|
|  relDataList|推荐内容列表||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  relFileList|关联文件列表(不包含封面图片)||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  saveOrSubmit|操作(1:保存,2:提交)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改文章
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"articleContent": "",
|
|||
|
|
"articleDesc": "",
|
|||
|
|
"articleId": 0,
|
|||
|
|
"articleModule": 1,
|
|||
|
|
"articleName": "",
|
|||
|
|
"coverFile": {
|
|||
|
|
"fileId": 0
|
|||
|
|
},
|
|||
|
|
"isComment": 1,
|
|||
|
|
"isPraise": 1,
|
|||
|
|
"isTop": 0,
|
|||
|
|
"relDataList": [
|
|||
|
|
{
|
|||
|
|
"recommendId": 0,
|
|||
|
|
"recommendType": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"relFileList": [
|
|||
|
|
{
|
|||
|
|
"fileId": 0,
|
|||
|
|
"fileType": 1
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"saveOrSubmit": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumArticleEditDto|museumArticleEditDto|body|true|修改文章Dto|修改文章Dto|
|
|||
|
|
|  articleContent|文章内容||false|string||
|
|||
|
|
|  articleDesc|文章简介||false|string||
|
|||
|
|
|  articleId|文章ID||true|integer(int64)||
|
|||
|
|
|  articleModule|所属模块(1:展馆动态,2:精品文章,3:展馆概况,4:用户服务协议,5:隐私政策)||false|string||
|
|||
|
|
|  articleName|文章名称||false|string||
|
|||
|
|
|  coverFile|封面文件||false|封面文件新增及修改Dto|封面文件新增及修改Dto|
|
|||
|
|
|    fileId|封面文件ID||false|integer||
|
|||
|
|
|  isComment|是否允许评论;(0:否,1:是)||false|string||
|
|||
|
|
|  isPraise|是否允许点赞;(0:否,1:是)||false|string||
|
|||
|
|
|  isTop|是否置顶;(0:否,1:是)||false|string||
|
|||
|
|
|  relDataList|推荐内容列表||false|array|推荐数据新增或修改Dto|
|
|||
|
|
|    recommendId|推荐数据ID||false|integer||
|
|||
|
|
|    recommendType|推荐数据类型||false|string||
|
|||
|
|
|  relFileList|关联文件列表(不包含封面图片)||false|array|楼层、展厅、藏品、文章新增或修改多媒体文件Dto|
|
|||
|
|
|    fileId|文件ID||true|integer||
|
|||
|
|
|    fileType|文件类型(1:图片,2:视频,3:音频,4:模型)||true|string||
|
|||
|
|
|  saveOrSubmit|操作(1:保存,2:提交)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/approve`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approveOpinion": "",
|
|||
|
|
"approveStatus": "",
|
|||
|
|
"articleId": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumArticleApproveDto|museumArticleApproveDto|body|true|文章审核Dto|文章审核Dto|
|
|||
|
|
|  approveOpinion|审核意见||false|string||
|
|||
|
|
|  approveStatus|审核操作(1:通过,2:驳回)||true|string||
|
|||
|
|
|  articleId|文章ID||true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出查询文章列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleModule|所属模块(1:展馆动态,2:精品文章,3:展馆概况,4:用户服务协议,5:隐私政策)|query|false|string||
|
|||
|
|
|articleName|文章名称|query|false|string||
|
|||
|
|
|articleStatus|文章状态;(0:待审核,1:已上架,2:已下架,4:已驳回,9:草稿)|query|false|array|string|
|
|||
|
|
|createBy|发布者名称|query|false|string||
|
|||
|
|
|isTop|是否置顶;(0:否,1:是)|query|false|string||
|
|||
|
|
|onlineBeginTime|发布开始时间|query|false|string(date)||
|
|||
|
|
|onlineEndTime|发布结束时间|query|false|string(date)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBeginTime|编辑开始时间|query|false|string(date)||
|
|||
|
|
|updateEndTime|编辑结束时间|query|false|string(date)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleModule|所属模块(1:展馆动态,2:精品文章,3:展馆概况,4:用户服务协议,5:隐私政策)|query|false|string||
|
|||
|
|
|articleName|文章名称|query|false|string||
|
|||
|
|
|articleStatus|文章状态;(0:待审核,1:已上架,2:已下架,4:已驳回,9:草稿)|query|false|array|string|
|
|||
|
|
|createBy|发布者名称|query|false|string||
|
|||
|
|
|isTop|是否置顶;(0:否,1:是)|query|false|string||
|
|||
|
|
|onlineBeginTime|发布开始时间|query|false|string(date)||
|
|||
|
|
|onlineEndTime|发布结束时间|query|false|string(date)||
|
|||
|
|
|pageNum|分页参数|query|false|integer(int32)||
|
|||
|
|
|pageSize|分页参数|query|false|integer(int32)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBeginTime|编辑开始时间|query|false|string(date)||
|
|||
|
|
|updateEndTime|编辑结束时间|query|false|string(date)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章下架
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/offline/{articleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleId|articleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 文章置顶与取消置顶
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/toTop`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"articleId": 0,
|
|||
|
|
"isTop": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|museumArticleToTopDto|museumArticleToTopDto|body|true|文章置顶与取消Dto|文章置顶与取消Dto|
|
|||
|
|
|  articleId|文章ID||true|integer(int64)||
|
|||
|
|
|  isTop|置顶操作(1:置顶,2:取消置顶)||true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除文章
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/{articleIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleIds|articleIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取文章详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/museumArticle/{articleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|articleId|articleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 消息推送
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 筛选用户推送列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/message/push/pushList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|activeStatus||query|false|string||
|
|||
|
|
|articleName|文章名称(100)|query|false|string||
|
|||
|
|
|createEnd|注册时间 :结束日期(10)|query|false|string||
|
|||
|
|
|createStart|注册时间 :开始日期(10)|query|false|string||
|
|||
|
|
|dataType|数据类型: 4:藏品 5:文章 6:展览|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|exhibitType|藏品类型(10)|query|false|string||
|
|||
|
|
|exhibitionName|展览名称(100)|query|false|string||
|
|||
|
|
|pushTag|推送标签|query|false|string||
|
|||
|
|
|reserveType|预约类型(10)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userAddress||query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 对用户消息进行推送
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/message/push/pushMessage`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|activeStatus||query|false|string||
|
|||
|
|
|articleName|文章名称(100)|query|false|string||
|
|||
|
|
|completeNum|已推送人数|query|false|integer(int32)||
|
|||
|
|
|createEnd|注册时间 :结束日期(10)|query|false|string||
|
|||
|
|
|createStart|注册时间 :开始日期(10)|query|false|string||
|
|||
|
|
|dataType|数据类型: 4:藏品 5:文章 6:展览|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|exhibitType|藏品类型(10)|query|false|string||
|
|||
|
|
|exhibitionName|展览名称(100)|query|false|string||
|
|||
|
|
|messageContent|消息模板内容|query|false|string||
|
|||
|
|
|messageType|消息模板类型,1:验证码,2:短信通知,3:推广短信|query|false|string||
|
|||
|
|
|planTime|预定计划时间|query|false|string(date-time)||
|
|||
|
|
|pushId|消息推送ID|query|false|integer(int64)||
|
|||
|
|
|pushNum|人数|query|false|integer(int32)||
|
|||
|
|
|pushTag|推送标签|query|false|string||
|
|||
|
|
|pushType|推送类型,1:立即推送,2:定时推送|query|false|string||
|
|||
|
|
|reserveType|预约类型(10)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userAddress||query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 用户收藏
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询收藏列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataCollection/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|collectionBy|收藏人|query|false|string||
|
|||
|
|
|dataName|收藏名称|query|false|string||
|
|||
|
|
|dataType|收藏类型 4:藏品,5:文章,6:展览|query|false|string||
|
|||
|
|
|reqType|请求类型{0:后台,1:前台}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 用户联系人
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户id查询注册用户联系人
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/userContact/getContactList/{userId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userId|userId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 用户联系人-前台
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除联系人
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userContact/delete/{ids}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ids|ids|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询注册用户联系人列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userContact/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据身份证获取购票类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userContact/noLogin/getTickerTYpe`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|cardNo|cardNo|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改联系人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/userContact/update`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"contactCardNo": "",
|
|||
|
|
"contactCardType": "",
|
|||
|
|
"contactId": 0,
|
|||
|
|
"contactName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|UpdateContactDto|UpdateContactDto|
|
|||
|
|
|  contactCardNo|联系人证件号码||false|string||
|
|||
|
|
|  contactCardType|联系人证件类型(0:居民身份证,1:港澳台通行证)||false|string||
|
|||
|
|
|  contactId|联系人Id||false|integer(int64)||
|
|||
|
|
|  contactName|联系人姓名||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 统计分析
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询注册用户统计
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/analysis/countRegisteredUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|timeType|timeType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询浏览量统计
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/analysis/countViewNum`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|dataType|query|true|string||
|
|||
|
|
|timeType|timeType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询数据分类饼图
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/analysis/dataTypePie`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|dataType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/analysis/reserveDetail`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约趋势
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/analysis/reserveTrend`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|timeType|timeType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询浏览量TOP10
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/analysis/viewNumTop`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataType|dataType|query|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 评论管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量评论审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataComment/approves`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approveStatus": "",
|
|||
|
|
"commentId": []
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataCommentApprovalDTO|dataCommentApprovalDTO|body|true|评论审核dto|评论审核dto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approveStatus|审核操作(0:初始,1:通过,2:驳回)||false|string||
|
|||
|
|
|  commentId|评论ID||false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章藏品详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataComment/detail/{commentId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentId|commentId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 评论管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataComment/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|commentBy|评论人|query|false|string||
|
|||
|
|
|commentContent|评论内容|query|false|string||
|
|||
|
|
|commentStatus|评论状态 0初始,1通过,2不通过|query|false|string||
|
|||
|
|
|dataType|数据类型 4:藏品,5:文章|query|false|string||
|
|||
|
|
|databaseAlias|数据库别名|query|false|string||
|
|||
|
|
|endTime|结束时间|query|false|string||
|
|||
|
|
|startTime|开始时间|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询文章藏品评论
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataComment/list/{dataId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dataId|dataId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 统计今日评论数量
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/dataComment/number`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 页面模板配置管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增页面模板配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/pageModel`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"modelDesc": "",
|
|||
|
|
"modelId": 0,
|
|||
|
|
"modelName": "",
|
|||
|
|
"modelStatus": "",
|
|||
|
|
"tenantId": 0,
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|pageModel|页面模板配置表|body|true|PageModel对象|PageModel对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志;(0:未删除,1:已删除)||false|string||
|
|||
|
|
|  modelDesc|页面模板描述||false|string||
|
|||
|
|
|  modelId|页面模板ID||false|integer(int64)||
|
|||
|
|
|  modelName|页面模板名称||false|string||
|
|||
|
|
|  modelStatus|页面模板状态;(0:未应用,1:已应用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|integer(int64)||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改页面模板配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/pageModel`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"modelDesc": "",
|
|||
|
|
"modelId": 0,
|
|||
|
|
"modelName": "",
|
|||
|
|
"modelStatus": "",
|
|||
|
|
"tenantId": 0,
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|pageModel|页面模板配置表|body|true|PageModel对象|PageModel对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志;(0:未删除,1:已删除)||false|string||
|
|||
|
|
|  modelDesc|页面模板描述||false|string||
|
|||
|
|
|  modelId|页面模板ID||false|integer(int64)||
|
|||
|
|
|  modelName|页面模板名称||false|string||
|
|||
|
|
|  modelStatus|页面模板状态;(0:未应用,1:已应用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|integer(int64)||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出页面模板配置查询列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/pageModel/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|modelName|页面模板名称|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询页面模板配置列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/pageModel/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|modelName|页面模板名称|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除页面模板配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/pageModel/{modelIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|modelIds|modelIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取页面模板配置详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/pageModel/{modelId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|modelId|modelId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 预约要素
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约(线下)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/add`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"exhibitionId": 0,
|
|||
|
|
"isPay": "",
|
|||
|
|
"reserveChannel": "",
|
|||
|
|
"reserveCompany": "",
|
|||
|
|
"reserveDate": "",
|
|||
|
|
"reserveNum": 0,
|
|||
|
|
"reserveReason": "",
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userRealName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|baseAddDTO|baseAddDTO|body|true|BaseAddDto|BaseAddDto|
|
|||
|
|
|  exhibitionId|展览ID||false|integer(int64)||
|
|||
|
|
|  isPay|是否购票;(0:否,1:是)||false|string||
|
|||
|
|
|  reserveChannel|预约渠道||false|string||
|
|||
|
|
|  reserveCompany|预约单位||false|string||
|
|||
|
|
|  reserveDate|预约时间||false|string(date)||
|
|||
|
|
|  reserveNum|预约人数||false|integer(int32)||
|
|||
|
|
|  reserveReason|预约原因||false|string||
|
|||
|
|
|  userCardNo|用户身份证号码||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userRealName|用户真实名称||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退订审核
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/baseApproval`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"approvalDesc": "",
|
|||
|
|
"approvalStatus": "",
|
|||
|
|
"dataId": 0,
|
|||
|
|
"dataType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|addDto|addDto|body|true|DataApprovalAddDto|DataApprovalAddDto|
|
|||
|
|
|  approvalDesc|审核描述||false|string||
|
|||
|
|
|  approvalStatus|审核状态;(0:初始,1:通过,2:不通过)||false|string||
|
|||
|
|
|  dataId|数据ID||false|integer(int64)||
|
|||
|
|
|  dataType|数据类型||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消预约
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/cancle/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 核销
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/check/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除预约
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/delete`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ids|ids|query|false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改预约(线下)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/edit`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"reserveDate": "",
|
|||
|
|
"reserveId": 0,
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userPhone": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderUpdateDto|orderUpdateDto|body|true|OrderUpdateDto|OrderUpdateDto|
|
|||
|
|
|  reserveDate|预约时间||false|string(date-time)||
|
|||
|
|
|  reserveId|预约ID||false|integer(int64)||
|
|||
|
|
|  userCardNo|用户身份证号码||false|string||
|
|||
|
|
|  userCardType|用户证件类型||false|string||
|
|||
|
|
|  userName|用户名称||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 统计预约及核销人数
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/getNum`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据日期查询余票
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/getTicketNum/{exhibitionId}/{nowDate}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionId|exhibitionId|path|true|integer(int64)||
|
|||
|
|
|nowDate|nowDate|path|true|string(date)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退订
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/optOut`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ids|ids|query|true|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/query/getBaseInfo/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/reserve/query/getReserveList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createTimeEnd|预约时间止|query|false|string(date-time)||
|
|||
|
|
|createTimeStart|预约时间起|query|false|string(date-time)||
|
|||
|
|
|exhibitionName|展览名称|query|false|string||
|
|||
|
|
|isReturn|退订状态;(0:否,1:是 9:退款申请驳回 )|query|false|string||
|
|||
|
|
|reqType|请求类型{0:后台,1:移动端}|query|false|string||
|
|||
|
|
|reserveChannel|预约渠道{2:线上 1:线下}|query|false|string||
|
|||
|
|
|reserveDateEnd|参观时间止|query|false|string(date-time)||
|
|||
|
|
|reserveDateStart|参观时间起|query|false|string(date-time)||
|
|||
|
|
|reserveNumEnd|预约人数范围止|query|false|integer(int32)||
|
|||
|
|
|reserveNumStart|预约人数范围起|query|false|integer(int32)||
|
|||
|
|
|reserveStatus|预约状态|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userPhone|用户手机号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 预约要素-前台
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增预约(线上)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/addOrder`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"contacts": [
|
|||
|
|
{
|
|||
|
|
"contactCardNo": "",
|
|||
|
|
"contactCardType": "",
|
|||
|
|
"contactName": "",
|
|||
|
|
"reserveId": 0,
|
|||
|
|
"tickerType": "",
|
|||
|
|
"ticketPrice": 0
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"exhibitionId": 0,
|
|||
|
|
"payType": "",
|
|||
|
|
"reserveDate": "",
|
|||
|
|
"totalAmout": 0,
|
|||
|
|
"userPhone": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|orderAddDTO|orderAddDTO|body|true|OrderAddDto|OrderAddDto|
|
|||
|
|
|  contacts|用户预约联系人||false|array|ContactAddDto|
|
|||
|
|
|    contactCardNo|联系人证件号码||false|string||
|
|||
|
|
|    contactCardType|联系人证件类型||false|string||
|
|||
|
|
|    contactName|联系人姓名||false|string||
|
|||
|
|
|    reserveId|预约ID||false|integer||
|
|||
|
|
|    tickerType|门票类型||false|string||
|
|||
|
|
|    ticketPrice|门票价格||false|number||
|
|||
|
|
|  exhibitionId|展览ID||false|integer(int64)||
|
|||
|
|
|  payType|购票方式{1:线上购买 2:现场购买 }||false|string||
|
|||
|
|
|  reserveDate|参观日期||false|string(date-time)||
|
|||
|
|
|  totalAmout|预约单金额||false|number||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消预约
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/cancel/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 退订申请
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/cancelApply/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消退订申请
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/noCancelApply/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取预约周期内余票
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/noLogin/getOrderNum/{exhibitionId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|exhibitionId|exhibitionId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/query/getBaseInfo/{reserveId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|reserveId|reserveId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询预约列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/museum/front/reserve/query/getReserveList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createTimeEnd|预约时间止|query|false|string(date-time)||
|
|||
|
|
|createTimeStart|预约时间起|query|false|string(date-time)||
|
|||
|
|
|exhibitionName|展览名称|query|false|string||
|
|||
|
|
|isReturn|退订状态;(0:否,1:是 9:退款申请驳回 )|query|false|string||
|
|||
|
|
|reqType|请求类型{0:后台,1:移动端}|query|false|string||
|
|||
|
|
|reserveChannel|预约渠道{2:线上 1:线下}|query|false|string||
|
|||
|
|
|reserveDateEnd|参观时间止|query|false|string(date-time)||
|
|||
|
|
|reserveDateStart|参观时间起|query|false|string(date-time)||
|
|||
|
|
|reserveNumEnd|预约人数范围止|query|false|integer(int32)||
|
|||
|
|
|reserveNumStart|预约人数范围起|query|false|integer(int32)||
|
|||
|
|
|reserveStatus|预约状态|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userPhone|用户手机号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**简介**:系统模块接口文档
|
|||
|
|
|
|||
|
|
|
|||
|
|
**HOST**:xxxx.xxxx.xxx
|
|||
|
|
|
|||
|
|
|
|||
|
|
**联系人**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Version**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口路径**:/system/v2/api-docs
|
|||
|
|
|
|||
|
|
|
|||
|
|
[TOC]
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-个人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取个人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/profile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改个人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/profile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|SysUser对象|SysUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|SysDept对象|SysDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|SysDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|SysRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户头像上传
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/profile/avatar`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`multipart/form-data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|avatarfile|avatarfile|formData|true|file||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 个人信息重置密码
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/profile/updatePwd`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|newPassword|newPassword|query|false|string||
|
|||
|
|
|oldPassword|oldPassword|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"noticeContent": "",
|
|||
|
|
"noticeId": "",
|
|||
|
|
"noticeTitle": "",
|
|||
|
|
"noticeType": "",
|
|||
|
|
"releaseMechanism": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|notice|通知公告表|body|true|SysNotice对象|SysNotice对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0:未删除,1:已删除)||false|string||
|
|||
|
|
|  fileName|附件名称||false|string||
|
|||
|
|
|  fileUrl|附件地址||false|string||
|
|||
|
|
|  noticeContent|公告内容||false|string||
|
|||
|
|
|  noticeId|公告ID||false|string||
|
|||
|
|
|  noticeTitle|公告标题||false|string||
|
|||
|
|
|  noticeType|公告类型(1:通知,2:公告)||false|string||
|
|||
|
|
|  releaseMechanism|发布机构||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|公告状态(0:正常,1:关闭)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"noticeContent": "",
|
|||
|
|
"noticeId": "",
|
|||
|
|
"noticeTitle": "",
|
|||
|
|
"noticeType": "",
|
|||
|
|
"releaseMechanism": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|notice|通知公告表|body|true|SysNotice对象|SysNotice对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0:未删除,1:已删除)||false|string||
|
|||
|
|
|  fileName|附件名称||false|string||
|
|||
|
|
|  fileUrl|附件地址||false|string||
|
|||
|
|
|  noticeContent|公告内容||false|string||
|
|||
|
|
|  noticeId|公告ID||false|string||
|
|||
|
|
|  noticeTitle|公告标题||false|string||
|
|||
|
|
|  noticeType|公告类型(1:通知,2:公告)||false|string||
|
|||
|
|
|  releaseMechanism|发布机构||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|公告状态(0:正常,1:关闭)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice/delete/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 管理端-获取通知公告列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0:未删除,1:已删除)|query|false|string||
|
|||
|
|
|fileName|附件名称|query|false|string||
|
|||
|
|
|fileUrl|附件地址|query|false|string||
|
|||
|
|
|noticeContent|公告内容|query|false|string||
|
|||
|
|
|noticeId|公告ID|query|false|integer(int64)||
|
|||
|
|
|noticeTitle|公告标题|query|false|string||
|
|||
|
|
|noticeType|公告类型(1:通知,2:公告)|query|false|string||
|
|||
|
|
|releaseMechanism|发布机构|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|公告状态(0:正常,1:关闭)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 下线通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice/offlineNotice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 上线通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice/onlineNotice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 管理端-根据通知公告编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/notice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-公告-门户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 门户-获取通知公告列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/notice/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0:未删除,1:已删除)|query|false|string||
|
|||
|
|
|fileName|附件名称|query|false|string||
|
|||
|
|
|fileUrl|附件地址|query|false|string||
|
|||
|
|
|noticeContent|公告内容|query|false|string||
|
|||
|
|
|noticeId|公告ID|query|false|integer(int64)||
|
|||
|
|
|noticeTitle|公告标题|query|false|string||
|
|||
|
|
|noticeType|公告类型(1:通知,2:公告)|query|false|string||
|
|||
|
|
|releaseMechanism|发布机构|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|公告状态(0:正常,1:关闭)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 门户-根据通知公告编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/notice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-参数配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增参数配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"configId": "",
|
|||
|
|
"configKey": "",
|
|||
|
|
"configName": "",
|
|||
|
|
"configType": "",
|
|||
|
|
"configValue": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|config|参数配置表|body|true|SysConfig对象|SysConfig对象|
|
|||
|
|
|  configId|参数主键||false|string||
|
|||
|
|
|  configKey|参数键名||false|string||
|
|||
|
|
|  configName|参数名称||false|string||
|
|||
|
|
|  configType|系统内置(Y是 N否)||false|string||
|
|||
|
|
|  configValue|参数键值||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改参数配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"configId": "",
|
|||
|
|
"configKey": "",
|
|||
|
|
"configName": "",
|
|||
|
|
"configType": "",
|
|||
|
|
"configValue": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|config|参数配置表|body|true|SysConfig对象|SysConfig对象|
|
|||
|
|
|  configId|参数主键||false|string||
|
|||
|
|
|  configKey|参数键名||false|string||
|
|||
|
|
|  configName|参数名称||false|string||
|
|||
|
|
|  configType|系统内置(Y是 N否)||false|string||
|
|||
|
|
|  configValue|参数键值||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据参数键名查询参数值
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config/configKey/{configKey}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configKey|configKey|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出参数管理列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configId|参数主键|query|false|integer(int64)||
|
|||
|
|
|configKey|参数键名|query|false|string||
|
|||
|
|
|configName|参数名称|query|false|string||
|
|||
|
|
|configType|系统内置(Y是 N否)|query|false|string||
|
|||
|
|
|configValue|参数键值|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询参数管理列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configId|参数主键|query|false|integer(int64)||
|
|||
|
|
|configKey|参数键名|query|false|string||
|
|||
|
|
|configName|参数名称|query|false|string||
|
|||
|
|
|configType|系统内置(Y是 N否)|query|false|string||
|
|||
|
|
|configValue|参数键值|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 刷新参数缓存
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config/refreshCache`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除参数配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config/{configIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configIds|configIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据参数编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/config/{configId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|configId|configId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-在线用户监控
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询在线用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/online/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ipaddr|ipaddr|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|userName|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 强退用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/online/{tokenId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tokenId|tokenId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-字典数据
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"cssClass": "",
|
|||
|
|
"default": true,
|
|||
|
|
"dictCode": "",
|
|||
|
|
"dictLabel": "",
|
|||
|
|
"dictSort": 0,
|
|||
|
|
"dictType": "",
|
|||
|
|
"dictValue": "",
|
|||
|
|
"isDefault": "",
|
|||
|
|
"listClass": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dict|字典数据表|body|true|SysDictData对象|SysDictData对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  cssClass|样式属性(其他样式扩展)||false|string||
|
|||
|
|
|  default|||false|boolean||
|
|||
|
|
|  dictCode|字典编码||false|string||
|
|||
|
|
|  dictLabel|字典标签||false|string||
|
|||
|
|
|  dictSort|字典排序||false|integer(int64)||
|
|||
|
|
|  dictType|字典类型||false|string||
|
|||
|
|
|  dictValue|字典键值||false|string||
|
|||
|
|
|  isDefault|是否默认(Y是 N否)||false|string||
|
|||
|
|
|  listClass|表格字典样式||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"cssClass": "",
|
|||
|
|
"default": true,
|
|||
|
|
"dictCode": "",
|
|||
|
|
"dictLabel": "",
|
|||
|
|
"dictSort": 0,
|
|||
|
|
"dictType": "",
|
|||
|
|
"dictValue": "",
|
|||
|
|
"isDefault": "",
|
|||
|
|
"listClass": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dict|字典数据表|body|true|SysDictData对象|SysDictData对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  cssClass|样式属性(其他样式扩展)||false|string||
|
|||
|
|
|  default|||false|boolean||
|
|||
|
|
|  dictCode|字典编码||false|string||
|
|||
|
|
|  dictLabel|字典标签||false|string||
|
|||
|
|
|  dictSort|字典排序||false|integer(int64)||
|
|||
|
|
|  dictType|字典类型||false|string||
|
|||
|
|
|  dictValue|字典键值||false|string||
|
|||
|
|
|  isDefault|是否默认(Y是 N否)||false|string||
|
|||
|
|
|  listClass|表格字典样式||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出字典数据列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|cssClass|样式属性(其他样式扩展)|query|false|string||
|
|||
|
|
|default||query|false|boolean||
|
|||
|
|
|dictCode|字典编码|query|false|integer(int64)||
|
|||
|
|
|dictLabel|字典标签|query|false|string||
|
|||
|
|
|dictSort|字典排序|query|false|integer(int64)||
|
|||
|
|
|dictType|字典类型|query|false|string||
|
|||
|
|
|dictValue|字典键值|query|false|string||
|
|||
|
|
|isDefault|是否默认(Y是 N否)|query|false|string||
|
|||
|
|
|listClass|表格字典样式|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询字典数据列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|cssClass|样式属性(其他样式扩展)|query|false|string||
|
|||
|
|
|default||query|false|boolean||
|
|||
|
|
|dictCode|字典编码|query|false|integer(int64)||
|
|||
|
|
|dictLabel|字典标签|query|false|string||
|
|||
|
|
|dictSort|字典排序|query|false|integer(int64)||
|
|||
|
|
|dictType|字典类型|query|false|string||
|
|||
|
|
|dictValue|字典键值|query|false|string||
|
|||
|
|
|isDefault|是否默认(Y是 N否)|query|false|string||
|
|||
|
|
|listClass|表格字典样式|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据字典类型查询字典数据信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data/type/{dictType}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dictType|dictType|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data/{dictCodes}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dictCodes|dictCodes|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询字典数据详细
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/data/{dictCode}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dictCode|dictCode|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dictId": "",
|
|||
|
|
"dictName": "",
|
|||
|
|
"dictType": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dict|字典类型表|body|true|SysDictType对象|SysDictType对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dictId|字典主键||false|string||
|
|||
|
|
|  dictName|字典名称||false|string||
|
|||
|
|
|  dictType|字典类型||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dictId": "",
|
|||
|
|
"dictName": "",
|
|||
|
|
"dictType": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dict|字典类型表|body|true|SysDictType对象|SysDictType对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dictId|字典主键||false|string||
|
|||
|
|
|  dictName|字典名称||false|string||
|
|||
|
|
|  dictType|字典类型||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出字典类型列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dictId|字典主键|query|false|integer(int64)||
|
|||
|
|
|dictName|字典名称|query|false|string||
|
|||
|
|
|dictType|字典类型|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询字典类型列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dictId|字典主键|query|false|integer(int64)||
|
|||
|
|
|dictName|字典名称|query|false|string||
|
|||
|
|
|dictType|字典类型|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取字典选择框列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type/optionselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 刷新字典缓存
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type/refreshCache`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除字典类型
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type/{dictIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dictIds|dictIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询字典类型详细
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dict/type/{dictId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dictId|dictId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"postCode": "",
|
|||
|
|
"postId": "",
|
|||
|
|
"postName": "",
|
|||
|
|
"postSort": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|post|岗位表|body|true|SysPost对象|SysPost对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  flag|用户是否存在此岗位标识 默认不存在||false|boolean||
|
|||
|
|
|  postCode|岗位编码||false|string||
|
|||
|
|
|  postId|岗位序号||false|string||
|
|||
|
|
|  postName|岗位名称||false|string||
|
|||
|
|
|  postSort|岗位排序||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"postCode": "",
|
|||
|
|
"postId": "",
|
|||
|
|
"postName": "",
|
|||
|
|
"postSort": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|post|岗位表|body|true|SysPost对象|SysPost对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  flag|用户是否存在此岗位标识 默认不存在||false|boolean||
|
|||
|
|
|  postCode|岗位编码||false|string||
|
|||
|
|
|  postId|岗位序号||false|string||
|
|||
|
|
|  postName|岗位名称||false|string||
|
|||
|
|
|  postSort|岗位排序||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出岗位列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|flag|用户是否存在此岗位标识 默认不存在|query|false|boolean||
|
|||
|
|
|postCode|岗位编码|query|false|string||
|
|||
|
|
|postId|岗位序号|query|false|integer(int64)||
|
|||
|
|
|postName|岗位名称|query|false|string||
|
|||
|
|
|postSort|岗位排序|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取岗位列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|flag|用户是否存在此岗位标识 默认不存在|query|false|boolean||
|
|||
|
|
|postCode|岗位编码|query|false|string||
|
|||
|
|
|postId|岗位序号|query|false|integer(int64)||
|
|||
|
|
|postName|岗位名称|query|false|string||
|
|||
|
|
|postSort|岗位排序|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取岗位选择框列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post/optionselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post/{postIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|postIds|postIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据岗位编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/post/{postId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|postId|postId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
## add
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/operlog`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"businessType": "",
|
|||
|
|
"businessTypes": [],
|
|||
|
|
"deptName": "",
|
|||
|
|
"errorMsg": "",
|
|||
|
|
"jsonResult": "",
|
|||
|
|
"method": "",
|
|||
|
|
"operId": "",
|
|||
|
|
"operIp": "",
|
|||
|
|
"operLocation": "",
|
|||
|
|
"operName": "",
|
|||
|
|
"operParam": "",
|
|||
|
|
"operTime": "",
|
|||
|
|
"operUrl": "",
|
|||
|
|
"operatorType": "",
|
|||
|
|
"requestMethod": "",
|
|||
|
|
"status": "",
|
|||
|
|
"title": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|operLog|操作日志记录表|body|true|SysOperLog对象|SysOperLog对象|
|
|||
|
|
|  businessType|业务类型(0:其它,1:新增, 2:修改,3:删除,4:授权,5:导出,6:导入,7:强退,8:生成代码,9:清空数据)||false|string||
|
|||
|
|
|  businessTypes|业务类型数组||false|array|string|
|
|||
|
|
|  deptName|部门名称||false|string||
|
|||
|
|
|  errorMsg|错误消息||false|string||
|
|||
|
|
|  jsonResult|返回参数||false|string||
|
|||
|
|
|  method|请求方法||false|string||
|
|||
|
|
|  operId|日志主键||false|string||
|
|||
|
|
|  operIp|操作地址||false|string||
|
|||
|
|
|  operLocation|操作地点||false|string||
|
|||
|
|
|  operName|操作人员||false|string||
|
|||
|
|
|  operParam|请求参数||false|string||
|
|||
|
|
|  operTime|操作时间||false|string(date-time)||
|
|||
|
|
|  operUrl|请求URL||false|string||
|
|||
|
|
|  operatorType|操作类别(0:其它,1:后台用户,2:手机端用户)||false|string||
|
|||
|
|
|  requestMethod|请求方式||false|string||
|
|||
|
|
|  status|操作状态(0:正常,1:异常)||false|string||
|
|||
|
|
|  title|操作模块||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 清除日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/operlog/clean`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/operlog/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|业务类型(0:其它,1:新增, 2:修改,3:删除,4:授权,5:导出,6:导入,7:强退,8:生成代码,9:清空数据)|query|false|string||
|
|||
|
|
|businessTypes|业务类型数组|query|false|array|string|
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|errorMsg|错误消息|query|false|string||
|
|||
|
|
|jsonResult|返回参数|query|false|string||
|
|||
|
|
|method|请求方法|query|false|string||
|
|||
|
|
|operId|日志主键|query|false|integer(int64)||
|
|||
|
|
|operIp|操作地址|query|false|string||
|
|||
|
|
|operLocation|操作地点|query|false|string||
|
|||
|
|
|operName|操作人员|query|false|string||
|
|||
|
|
|operParam|请求参数|query|false|string||
|
|||
|
|
|operTime|操作时间|query|false|string(date-time)||
|
|||
|
|
|operUrl|请求URL|query|false|string||
|
|||
|
|
|operatorType|操作类别(0:其它,1:后台用户,2:手机端用户)|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|requestMethod|请求方式|query|false|string||
|
|||
|
|
|status|操作状态(0:正常,1:异常)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|title|操作模块|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 日志列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/operlog/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|业务类型(0:其它,1:新增, 2:修改,3:删除,4:授权,5:导出,6:导入,7:强退,8:生成代码,9:清空数据)|query|false|string||
|
|||
|
|
|businessTypes|业务类型数组|query|false|array|string|
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|errorMsg|错误消息|query|false|string||
|
|||
|
|
|jsonResult|返回参数|query|false|string||
|
|||
|
|
|method|请求方法|query|false|string||
|
|||
|
|
|operId|日志主键|query|false|integer(int64)||
|
|||
|
|
|operIp|操作地址|query|false|string||
|
|||
|
|
|operLocation|操作地点|query|false|string||
|
|||
|
|
|operName|操作人员|query|false|string||
|
|||
|
|
|operParam|请求参数|query|false|string||
|
|||
|
|
|operTime|操作时间|query|false|string(date-time)||
|
|||
|
|
|operUrl|请求URL|query|false|string||
|
|||
|
|
|operatorType|操作类别(0:其它,1:后台用户,2:手机端用户)|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|requestMethod|请求方式|query|false|string||
|
|||
|
|
|status|操作状态(0:正常,1:异常)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|title|操作模块|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/operlog/{operIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|operIds|operIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|SysUser对象|SysUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|SysDept对象|SysDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|SysDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|SysRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|SysUser对象|SysUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|SysDept对象|SysDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|SysDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|SysRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|userId|path|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户授权角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/authRole`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleIds|roleIds|query|false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|userId|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户编号获取授权角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/authRole/{userId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userId|userId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户状态修改
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/changeStatus/{id}/{status}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|id|id|path|true|integer(int64)||
|
|||
|
|
|status|status|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/getInfo`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取当前用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/getSysUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«SysUser对象»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||SysUser对象|SysUser对象|
|
|||
|
|
|  admin||boolean||
|
|||
|
|
|  avatar|用户头像|string||
|
|||
|
|
|  createBy|创建人|string||
|
|||
|
|
|  createTime|创建时间|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|  dept|部门对象|SysDept对象|SysDept对象|
|
|||
|
|
|    ancestors|祖级列表|string||
|
|||
|
|
|    children|子部门|array|SysDept对象|
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    deptName|部门名称|string||
|
|||
|
|
|    deptType|部门类型|string||
|
|||
|
|
|    email|邮箱|string||
|
|||
|
|
|    leader|负责人|string||
|
|||
|
|
|    orderNum|显示顺序|string||
|
|||
|
|
|    parentId|父部门ID|string||
|
|||
|
|
|    parentName|父部门名称|string||
|
|||
|
|
|    phone|联系电话|string||
|
|||
|
|
|    status|部门状态|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|  deptId|部门ID|string||
|
|||
|
|
|  email|用户邮箱|string||
|
|||
|
|
|  loginDate|最后登录时间|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP|string||
|
|||
|
|
|  nickName|用户昵称|string||
|
|||
|
|
|  password|密码|string||
|
|||
|
|
|  phonenumber|手机号码|string||
|
|||
|
|
|  postIds|岗位组|string||
|
|||
|
|
|  remark|备注|string||
|
|||
|
|
|  roleId|角色ID|string||
|
|||
|
|
|  roleIds|角色组|string||
|
|||
|
|
|  roles|角色对象|array|SysRole对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|    menuIds|菜单组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleKey|角色权限|string||
|
|||
|
|
|    roleName|角色名称|string||
|
|||
|
|
|    roleSort|角色排序|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|  sex|用户性别|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|  updateBy|更新人|string||
|
|||
|
|
|  updateTime|更新时间|string(date-time)||
|
|||
|
|
|  userId|用户ID|string||
|
|||
|
|
|  userName|用户账号|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导入用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/importData`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`multipart/form-data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|file|file|formData|false|file||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateSupport|updateSupport|query|false|boolean||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导入模板
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/importTemplate`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取当前用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/info/{username}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|username|username|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«LoginUser»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||LoginUser|LoginUser|
|
|||
|
|
|  expireTime||integer(int64)||
|
|||
|
|
|  ipaddr||string||
|
|||
|
|
|  loginTime||integer(int64)||
|
|||
|
|
|  permissions||array|string|
|
|||
|
|
|  roles||array|string|
|
|||
|
|
|  sysUser||SysUser对象|SysUser对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    avatar|用户头像|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    dept|部门对象|SysDept对象|SysDept对象|
|
|||
|
|
|      ancestors|祖级列表|string||
|
|||
|
|
|      children|子部门|array|SysDept对象|
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptId|部门ID|string||
|
|||
|
|
|      deptName|部门名称|string||
|
|||
|
|
|      deptType|部门类型|string||
|
|||
|
|
|      email|邮箱|string||
|
|||
|
|
|      leader|负责人|string||
|
|||
|
|
|      orderNum|显示顺序|string||
|
|||
|
|
|      parentId|父部门ID|string||
|
|||
|
|
|      parentName|父部门名称|string||
|
|||
|
|
|      phone|联系电话|string||
|
|||
|
|
|      status|部门状态|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    email|用户邮箱|string||
|
|||
|
|
|    loginDate|最后登录时间|string||
|
|||
|
|
|    loginIp|最后登录IP|string||
|
|||
|
|
|    nickName|用户昵称|string||
|
|||
|
|
|    password|密码|string||
|
|||
|
|
|    phonenumber|手机号码|string||
|
|||
|
|
|    postIds|岗位组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleIds|角色组|string||
|
|||
|
|
|    roles|角色对象|array|SysRole对象|
|
|||
|
|
|      admin||boolean||
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|      deptIds|部门组(数据权限)|string||
|
|||
|
|
|      flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|      menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|      menuIds|菜单组|string||
|
|||
|
|
|      remark|备注|string||
|
|||
|
|
|      roleId|角色ID|string||
|
|||
|
|
|      roleKey|角色权限|string||
|
|||
|
|
|      roleName|角色名称|string||
|
|||
|
|
|      roleSort|角色排序|string||
|
|||
|
|
|      status|角色状态(0正常 1停用)|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    sex|用户性别|string||
|
|||
|
|
|    status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userId|用户ID|string||
|
|||
|
|
|    userName|用户账号|string||
|
|||
|
|
|    userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|  tenantUser||TenantUser对象|TenantUser对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    avatar|用户头像|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    dept|部门对象|TenantDept对象|TenantDept对象|
|
|||
|
|
|      ancestors|祖级列表|string||
|
|||
|
|
|      children|子部门|array|TenantDept对象|
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptId|部门ID|string||
|
|||
|
|
|      deptName|部门名称|string||
|
|||
|
|
|      deptType|部门类型|string||
|
|||
|
|
|      email|邮箱|string||
|
|||
|
|
|      leader|负责人|string||
|
|||
|
|
|      orderNum|显示顺序|string||
|
|||
|
|
|      parentId|父部门ID|string||
|
|||
|
|
|      parentName|父部门名称|string||
|
|||
|
|
|      phone|联系电话|string||
|
|||
|
|
|      status|部门状态|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    email|用户邮箱|string||
|
|||
|
|
|    loginDate|最后登录时间|string||
|
|||
|
|
|    loginIp|最后登录IP|string||
|
|||
|
|
|    nickName|用户昵称|string||
|
|||
|
|
|    password|密码|string||
|
|||
|
|
|    phonenumber|手机号码|string||
|
|||
|
|
|    postIds|岗位组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleIds|角色组|string||
|
|||
|
|
|    roles|角色对象|array|TenantRole对象|
|
|||
|
|
|      admin||boolean||
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|      deptIds|部门组(数据权限)|string||
|
|||
|
|
|      flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|      menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|      menuIds|菜单组|string||
|
|||
|
|
|      remark|备注|string||
|
|||
|
|
|      roleId|角色ID|string||
|
|||
|
|
|      roleKey|角色权限|string||
|
|||
|
|
|      roleName|角色名称|string||
|
|||
|
|
|      roleSort|角色排序|string||
|
|||
|
|
|      status|角色状态(0正常 1停用)|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    sex|用户性别|string||
|
|||
|
|
|    status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userId|用户ID|string||
|
|||
|
|
|    userName|用户账号|string||
|
|||
|
|
|    userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|  token||string||
|
|||
|
|
|  userid||integer(int64)||
|
|||
|
|
|  username||string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"expireTime": 0,
|
|||
|
|
"ipaddr": "",
|
|||
|
|
"loginTime": 0,
|
|||
|
|
"permissions": [],
|
|||
|
|
"roles": [],
|
|||
|
|
"sysUser": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"tenantUser": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"token": "",
|
|||
|
|
"userid": 0,
|
|||
|
|
"username": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询部门用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/listByDept/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 注册用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/register`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|sysUser|用户对象|body|true|SysUser对象|SysUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|SysDept对象|SysDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|SysDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|SysRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«boolean»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||boolean||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": true,
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户重置密码
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/resetPwd`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|SysUser对象|SysUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|SysDept对象|SysDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|SysDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|SysRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/{userIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userIds|userIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/user/{userId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userId|userId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-用户-门户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取token
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/user/getToken`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"appCode": "",
|
|||
|
|
"appToken": "",
|
|||
|
|
"appUrl": "",
|
|||
|
|
"password": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|getTokenDto|获取Token信息Dto|body|true|GetTokenDto对象|GetTokenDto对象|
|
|||
|
|
|  appCode|应用服务编码||false|string||
|
|||
|
|
|  appToken|应用服务签名||false|string||
|
|||
|
|
|  appUrl|应用服务请求地址||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|GetTokenDto对象|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|appCode|应用服务编码|string||
|
|||
|
|
|appToken|应用服务签名|string||
|
|||
|
|
|appUrl|应用服务请求地址|string||
|
|||
|
|
|password|密码|string||
|
|||
|
|
|userName|用户账号|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"appCode": "",
|
|||
|
|
"appToken": "",
|
|||
|
|
"appUrl": "",
|
|||
|
|
"password": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/user/syncList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-登录日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
## add
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/logininfor`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"accessTime": "",
|
|||
|
|
"infoId": "",
|
|||
|
|
"ipaddr": "",
|
|||
|
|
"msg": "",
|
|||
|
|
"status": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|logininfor|系统访问记录表|body|true|SysLogininfor对象|SysLogininfor对象|
|
|||
|
|
|  accessTime|访问时间||false|string(date-time)||
|
|||
|
|
|  infoId|ID||false|string||
|
|||
|
|
|  ipaddr|地址||false|string||
|
|||
|
|
|  msg|描述||false|string||
|
|||
|
|
|  status|状态(0:成功,1:失败)||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 清除登录日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/logininfor/clean`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出登录日志列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/logininfor/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|accessTime|访问时间|query|false|string(date-time)||
|
|||
|
|
|infoId|ID|query|false|integer(int64)||
|
|||
|
|
|ipaddr|地址|query|false|string||
|
|||
|
|
|msg|描述|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|status|状态(0:成功,1:失败)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询登录日志列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/logininfor/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|accessTime|访问时间|query|false|string(date-time)||
|
|||
|
|
|infoId|ID|query|false|integer(int64)||
|
|||
|
|
|ipaddr|地址|query|false|string||
|
|||
|
|
|msg|描述|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|status|状态(0:成功,1:失败)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除登录日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/logininfor/{infoIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|infoIds|infoIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-租户管理
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增租户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"email": "",
|
|||
|
|
"endDate": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"sex": "",
|
|||
|
|
"startDate": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"tenantName": "",
|
|||
|
|
"tenantNo": "",
|
|||
|
|
"tenantType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenantDto|租户管理表Dto|body|true|SysTenantDto对象|SysTenantDto对象|
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  endDate|租户系统到期时间||false|string(date)||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  startDate|租户系统开始时间||false|string(date)||
|
|||
|
|
|  status|租户状态(0:正常,1:停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  tenantName|租户名称||false|string||
|
|||
|
|
|  tenantNo|租户编号||false|string||
|
|||
|
|
|  tenantType|租户类型||false|string||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改租户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"email": "",
|
|||
|
|
"endDate": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"sex": "",
|
|||
|
|
"startDate": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"tenantName": "",
|
|||
|
|
"tenantNo": "",
|
|||
|
|
"tenantType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenantDto|租户管理表Dto|body|true|SysTenantDto对象|SysTenantDto对象|
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  endDate|租户系统到期时间||false|string(date)||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  startDate|租户系统开始时间||false|string(date)||
|
|||
|
|
|  status|租户状态(0:正常,1:停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  tenantName|租户名称||false|string||
|
|||
|
|
|  tenantNo|租户编号||false|string||
|
|||
|
|
|  tenantType|租户类型||false|string||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 租户状态修改
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/changeStatus/{tenantIds}/{status}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|status|status|path|true|string||
|
|||
|
|
|tenantIds|tenantIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出租户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|endDate|租户系统到期时间|query|false|string||
|
|||
|
|
|startDate|租户系统开始时间|query|false|string||
|
|||
|
|
|tenantName|租户名称|query|false|string||
|
|||
|
|
|tenantNo|租户编号|query|false|string||
|
|||
|
|
|tenantStatus|租户显示状态(1:禁用,2:未开通,3:已开通,4:已过期)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询租户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|endDate|租户系统到期时间|query|false|string||
|
|||
|
|
|startDate|租户系统开始时间|query|false|string||
|
|||
|
|
|tenantName|租户名称|query|false|string||
|
|||
|
|
|tenantNo|租户编号|query|false|string||
|
|||
|
|
|tenantStatus|租户显示状态(1:禁用,2:未开通,3:已开通,4:已过期)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询租户详细
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/selectById/{tenandId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenandId|tenandId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«SysTenant对象»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||SysTenant对象|SysTenant对象|
|
|||
|
|
|  createBy|创建人|string||
|
|||
|
|
|  createTime|创建时间|string(date-time)||
|
|||
|
|
|  endDate|租户系统到期时间|string(date-time)||
|
|||
|
|
|  logoUrl|租户LOGO|string||
|
|||
|
|
|  remark|备注|string||
|
|||
|
|
|  startDate|租户系统开始时间|string(date-time)||
|
|||
|
|
|  status|租户状态(0:正常,1:停用)|string||
|
|||
|
|
|  tenantId|租户ID|string||
|
|||
|
|
|  tenantName|租户名称|string||
|
|||
|
|
|  tenantNo|租户编号|string||
|
|||
|
|
|  tenantStatus|租户显示状态(1:禁用,2:未开通,3:已开通,4:已过期)|string||
|
|||
|
|
|  tenantType|租户类型|string||
|
|||
|
|
|  updateBy|更新人|string||
|
|||
|
|
|  updateTime|更新时间|string(date-time)||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"endDate": "",
|
|||
|
|
"logoUrl": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"startDate": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"tenantName": "",
|
|||
|
|
"tenantNo": "",
|
|||
|
|
"tenantStatus": "",
|
|||
|
|
"tenantType": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询租户详细
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/{tenandId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenandId|tenandId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-租户管理-门户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增租户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"email": "",
|
|||
|
|
"endDate": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"sex": "",
|
|||
|
|
"startDate": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"tenantName": "",
|
|||
|
|
"tenantNo": "",
|
|||
|
|
"tenantType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenantDto|租户管理表Dto|body|true|SysTenantDto对象|SysTenantDto对象|
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  endDate|租户系统到期时间||false|string(date)||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  startDate|租户系统开始时间||false|string(date)||
|
|||
|
|
|  status|租户状态(0:正常,1:停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  tenantName|租户名称||false|string||
|
|||
|
|
|  tenantNo|租户编号||false|string||
|
|||
|
|
|  tenantType|租户类型||false|string||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改租户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"email": "",
|
|||
|
|
"endDate": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"sex": "",
|
|||
|
|
"startDate": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"tenantName": "",
|
|||
|
|
"tenantNo": "",
|
|||
|
|
"tenantType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenantDto|租户管理表Dto|body|true|SysTenantDto对象|SysTenantDto对象|
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  endDate|租户系统到期时间||false|string(date)||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  startDate|租户系统开始时间||false|string(date)||
|
|||
|
|
|  status|租户状态(0:正常,1:停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  tenantName|租户名称||false|string||
|
|||
|
|
|  tenantNo|租户编号||false|string||
|
|||
|
|
|  tenantType|租户类型||false|string||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 租户状态修改
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant/changeStatus/{tenantIds}/{status}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|status|status|path|true|string||
|
|||
|
|
|tenantIds|tenantIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出租户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|endDate|租户系统到期时间|query|false|string||
|
|||
|
|
|startDate|租户系统开始时间|query|false|string||
|
|||
|
|
|tenantName|租户名称|query|false|string||
|
|||
|
|
|tenantNo|租户编号|query|false|string||
|
|||
|
|
|tenantStatus|租户显示状态(1:禁用,2:未开通,3:已开通,4:已过期)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询租户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|endDate|租户系统到期时间|query|false|string||
|
|||
|
|
|startDate|租户系统开始时间|query|false|string||
|
|||
|
|
|tenantName|租户名称|query|false|string||
|
|||
|
|
|tenantNo|租户编号|query|false|string||
|
|||
|
|
|tenantStatus|租户显示状态(1:禁用,2:未开通,3:已开通,4:已过期)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询租户详细
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant/{tenandId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenandId|tenandId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"children": [],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menu|菜单权限表|body|true|SysMenu对象|SysMenu对象|
|
|||
|
|
|  children|子菜单||false|array|SysMenu对象|
|
|||
|
|
|  component|组件路径||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  icon|菜单图标||false|string||
|
|||
|
|
|  isCache|是否缓存(0缓存 1不缓存)||false|string||
|
|||
|
|
|  isFrame|是否为外链(0是 1否)||false|string||
|
|||
|
|
|  menuId|菜单ID||false|string||
|
|||
|
|
|  menuName|菜单名称||false|string||
|
|||
|
|
|  menuType|类型(M目录 C菜单 F按钮)||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父菜单ID||false|string||
|
|||
|
|
|  parentName|父菜单名称||false|string||
|
|||
|
|
|  path|路由地址||false|string||
|
|||
|
|
|  perms|权限字符串||false|string||
|
|||
|
|
|  query|路由参数||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|菜单状态(0显示 1隐藏)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  visible|显示状态(0显示 1隐藏)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"children": [],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menu|菜单权限表|body|true|SysMenu对象|SysMenu对象|
|
|||
|
|
|  children|子菜单||false|array|SysMenu对象|
|
|||
|
|
|  component|组件路径||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  icon|菜单图标||false|string||
|
|||
|
|
|  isCache|是否缓存(0缓存 1不缓存)||false|string||
|
|||
|
|
|  isFrame|是否为外链(0是 1否)||false|string||
|
|||
|
|
|  menuId|菜单ID||false|string||
|
|||
|
|
|  menuName|菜单名称||false|string||
|
|||
|
|
|  menuType|类型(M目录 C菜单 F按钮)||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父菜单ID||false|string||
|
|||
|
|
|  parentName|父菜单名称||false|string||
|
|||
|
|
|  path|路由地址||false|string||
|
|||
|
|
|  perms|权限字符串||false|string||
|
|||
|
|
|  query|路由参数||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|菜单状态(0显示 1隐藏)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  visible|显示状态(0显示 1隐藏)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取路由信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu/getRouters`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取菜单列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|component|组件路径|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|icon|菜单图标|query|false|string||
|
|||
|
|
|isCache|是否缓存(0缓存 1不缓存)|query|false|string||
|
|||
|
|
|isFrame|是否为外链(0是 1否)|query|false|string||
|
|||
|
|
|menuId|菜单ID|query|false|integer(int64)||
|
|||
|
|
|menuName|菜单名称|query|false|string||
|
|||
|
|
|menuType|类型(M目录 C菜单 F按钮)|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父菜单ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父菜单名称|query|false|string||
|
|||
|
|
|path|路由地址|query|false|string||
|
|||
|
|
|perms|权限字符串|query|false|string||
|
|||
|
|
|query|路由参数|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|菜单状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|visible|显示状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 加载对应角色菜单列表树
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu/roleMenuTreeselect/{roleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取菜单下拉树列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu/treeselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|component|组件路径|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|icon|菜单图标|query|false|string||
|
|||
|
|
|isCache|是否缓存(0缓存 1不缓存)|query|false|string||
|
|||
|
|
|isFrame|是否为外链(0是 1否)|query|false|string||
|
|||
|
|
|menuId|菜单ID|query|false|integer(int64)||
|
|||
|
|
|menuName|菜单名称|query|false|string||
|
|||
|
|
|menuType|类型(M目录 C菜单 F按钮)|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父菜单ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父菜单名称|query|false|string||
|
|||
|
|
|path|路由地址|query|false|string||
|
|||
|
|
|perms|权限字符串|query|false|string||
|
|||
|
|
|query|路由参数|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|菜单状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|visible|显示状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据菜单编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu/{menuId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menuId|menuId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/menu/{menuId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menuId|menuId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|role|角色表|body|true|SysRole对象|SysRole对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|  deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|  flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|  menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|  menuIds|菜单组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleKey|角色权限||false|string||
|
|||
|
|
|  roleName|角色名称||false|string||
|
|||
|
|
|  roleSort|角色排序||false|string||
|
|||
|
|
|  status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|role|角色表|body|true|SysRole对象|SysRole对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|  deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|  flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|  menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|  menuIds|菜单组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleKey|角色权限||false|string||
|
|||
|
|
|  roleName|角色名称||false|string||
|
|||
|
|
|  roleSort|角色排序||false|string||
|
|||
|
|
|  status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询已分配用户角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/authUser/allocatedList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消授权用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/authUser/cancel`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"roleId": "",
|
|||
|
|
"userId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userRole|用户和角色关联|body|true|SysUserRole对象|SysUserRole对象|
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量取消授权用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/authUser/cancelAll`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userIds|userIds|query|false|array|integer|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量选择用户授权
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/authUser/selectAll`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userIds|userIds|query|false|array|integer|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询未分配用户角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/authUser/unallocatedList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据权限
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/dataScope`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|role|角色表|body|true|SysRole对象|SysRole对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|  deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|  flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|  menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|  menuIds|菜单组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleKey|角色权限||false|string||
|
|||
|
|
|  roleName|角色名称||false|string||
|
|||
|
|
|  roleSort|角色排序||false|string||
|
|||
|
|
|  status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleKey|角色权限|query|false|string||
|
|||
|
|
|roleName|角色名称|query|false|string||
|
|||
|
|
|roleSort|角色排序|query|false|string||
|
|||
|
|
|status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleKey|角色权限|query|false|string||
|
|||
|
|
|roleName|角色名称|query|false|string||
|
|||
|
|
|roleSort|角色排序|query|false|string||
|
|||
|
|
|status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取角色选择框列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/optionselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/{roleIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleIds|roleIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据角色编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/role/{roleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 平台-部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dept|部门表|body|true|SysDept对象|SysDept对象|
|
|||
|
|
|  ancestors|祖级列表||false|string||
|
|||
|
|
|  children|子部门||false|array|SysDept对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  deptName|部门名称||false|string||
|
|||
|
|
|  deptType|部门类型||false|string||
|
|||
|
|
|  email|邮箱||false|string||
|
|||
|
|
|  leader|负责人||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父部门ID||false|string||
|
|||
|
|
|  parentName|父部门名称||false|string||
|
|||
|
|
|  phone|联系电话||false|string||
|
|||
|
|
|  status|部门状态||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dept|部门表|body|true|SysDept对象|SysDept对象|
|
|||
|
|
|  ancestors|祖级列表||false|string||
|
|||
|
|
|  children|子部门||false|array|SysDept对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  deptName|部门名称||false|string||
|
|||
|
|
|  deptType|部门类型||false|string||
|
|||
|
|
|  email|邮箱||false|string||
|
|||
|
|
|  leader|负责人||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父部门ID||false|string||
|
|||
|
|
|  parentName|父部门名称||false|string||
|
|||
|
|
|  phone|联系电话||false|string||
|
|||
|
|
|  status|部门状态||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取部门下拉树列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/getNormalDeptTree`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取部门列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ancestors|祖级列表|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|deptType|部门类型|query|false|string||
|
|||
|
|
|email|邮箱|query|false|string||
|
|||
|
|
|leader|负责人|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父部门名称|query|false|string||
|
|||
|
|
|phone|联系电话|query|false|string||
|
|||
|
|
|status|部门状态|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询部门列表(排除节点)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/list/exclude/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 加载对应角色部门列表树
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/roleDeptTreeselect/{roleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取部门下拉树列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/treeselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ancestors|祖级列表|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|deptType|部门类型|query|false|string||
|
|||
|
|
|email|邮箱|query|false|string||
|
|||
|
|
|leader|负责人|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父部门名称|query|false|string||
|
|||
|
|
|phone|联系电话|query|false|string||
|
|||
|
|
|status|部门状态|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据部门编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/dept/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 微信JS-SDK模块
|
|||
|
|
|
|||
|
|
|
|||
|
|
## wx-jssdk-config
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/wxMp/config`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|url|url|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 注册用户-前台
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 绑定手机号
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/bindPhone`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": "",
|
|||
|
|
"phone": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|BindPhoneDto|BindPhoneDto|
|
|||
|
|
|  code|||false|string||
|
|||
|
|
|  phone|||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 注销
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/cancel`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据userName获取用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/info/{userName}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|tenant_id|header|true|string||
|
|||
|
|
|userName|userName|path|true|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«AppLoginUser»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||AppLoginUser|AppLoginUser|
|
|||
|
|
|  customerUser||CustomerUser|CustomerUser|
|
|||
|
|
|    activeStatus|活跃状态,0:不活跃,1:活跃|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志;;0:未删除,1:已删除|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新者|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userAddress|用户注册地址|string||
|
|||
|
|
|    userCardNo|用户身份证号码|string||
|
|||
|
|
|    userCardType|用户证件类型(1:居民身份证,2:港澳台通行证)|string||
|
|||
|
|
|    userId|用户Id|string||
|
|||
|
|
|    userImg|用户头像|string||
|
|||
|
|
|    userName|用户名称|string||
|
|||
|
|
|    userNickName|用户昵称|string||
|
|||
|
|
|    userOpenId|用户微信ID|string||
|
|||
|
|
|    userPhone|用户手机号|string||
|
|||
|
|
|    userPwd|用户密码|string||
|
|||
|
|
|    userSex|用户性别(0:未知,1:男,2:女)|string||
|
|||
|
|
|  expireTime||integer(int64)||
|
|||
|
|
|  ipaddr||string||
|
|||
|
|
|  loginTime||integer(int64)||
|
|||
|
|
|  tenantUser||TenantUser对象|TenantUser对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    avatar|用户头像|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    dept|部门对象|TenantDept对象|TenantDept对象|
|
|||
|
|
|      ancestors|祖级列表|string||
|
|||
|
|
|      children|子部门|array|TenantDept对象|
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptId|部门ID|string||
|
|||
|
|
|      deptName|部门名称|string||
|
|||
|
|
|      deptType|部门类型|string||
|
|||
|
|
|      email|邮箱|string||
|
|||
|
|
|      leader|负责人|string||
|
|||
|
|
|      orderNum|显示顺序|string||
|
|||
|
|
|      parentId|父部门ID|string||
|
|||
|
|
|      parentName|父部门名称|string||
|
|||
|
|
|      phone|联系电话|string||
|
|||
|
|
|      status|部门状态|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    email|用户邮箱|string||
|
|||
|
|
|    loginDate|最后登录时间|string||
|
|||
|
|
|    loginIp|最后登录IP|string||
|
|||
|
|
|    nickName|用户昵称|string||
|
|||
|
|
|    password|密码|string||
|
|||
|
|
|    phonenumber|手机号码|string||
|
|||
|
|
|    postIds|岗位组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleIds|角色组|string||
|
|||
|
|
|    roles|角色对象|array|TenantRole对象|
|
|||
|
|
|      admin||boolean||
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|      deptIds|部门组(数据权限)|string||
|
|||
|
|
|      flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|      menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|      menuIds|菜单组|string||
|
|||
|
|
|      remark|备注|string||
|
|||
|
|
|      roleId|角色ID|string||
|
|||
|
|
|      roleKey|角色权限|string||
|
|||
|
|
|      roleName|角色名称|string||
|
|||
|
|
|      roleSort|角色排序|string||
|
|||
|
|
|      status|角色状态(0正常 1停用)|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    sex|用户性别|string||
|
|||
|
|
|    status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userId|用户ID|string||
|
|||
|
|
|    userName|用户账号|string||
|
|||
|
|
|    userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|  token||string||
|
|||
|
|
|  userid||integer(int64)||
|
|||
|
|
|  username||string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"customerUser": {
|
|||
|
|
"activeStatus": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userAddress": "",
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userImg": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userNickName": "",
|
|||
|
|
"userOpenId": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userPwd": "",
|
|||
|
|
"userSex": ""
|
|||
|
|
},
|
|||
|
|
"expireTime": 0,
|
|||
|
|
"ipaddr": "",
|
|||
|
|
"loginTime": 0,
|
|||
|
|
"tenantUser": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"token": "",
|
|||
|
|
"userid": 0,
|
|||
|
|
"username": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取验证码
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/noLogin/getCode/{phone}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|phone|phone|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据userPhone获取用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/phoneLogin/{userPhone}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|tenant_id|header|true|string||
|
|||
|
|
|userPhone|userPhone|path|true|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«AppLoginUser»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||AppLoginUser|AppLoginUser|
|
|||
|
|
|  customerUser||CustomerUser|CustomerUser|
|
|||
|
|
|    activeStatus|活跃状态,0:不活跃,1:活跃|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志;;0:未删除,1:已删除|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新者|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userAddress|用户注册地址|string||
|
|||
|
|
|    userCardNo|用户身份证号码|string||
|
|||
|
|
|    userCardType|用户证件类型(1:居民身份证,2:港澳台通行证)|string||
|
|||
|
|
|    userId|用户Id|string||
|
|||
|
|
|    userImg|用户头像|string||
|
|||
|
|
|    userName|用户名称|string||
|
|||
|
|
|    userNickName|用户昵称|string||
|
|||
|
|
|    userOpenId|用户微信ID|string||
|
|||
|
|
|    userPhone|用户手机号|string||
|
|||
|
|
|    userPwd|用户密码|string||
|
|||
|
|
|    userSex|用户性别(0:未知,1:男,2:女)|string||
|
|||
|
|
|  expireTime||integer(int64)||
|
|||
|
|
|  ipaddr||string||
|
|||
|
|
|  loginTime||integer(int64)||
|
|||
|
|
|  tenantUser||TenantUser对象|TenantUser对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    avatar|用户头像|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    dept|部门对象|TenantDept对象|TenantDept对象|
|
|||
|
|
|      ancestors|祖级列表|string||
|
|||
|
|
|      children|子部门|array|TenantDept对象|
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptId|部门ID|string||
|
|||
|
|
|      deptName|部门名称|string||
|
|||
|
|
|      deptType|部门类型|string||
|
|||
|
|
|      email|邮箱|string||
|
|||
|
|
|      leader|负责人|string||
|
|||
|
|
|      orderNum|显示顺序|string||
|
|||
|
|
|      parentId|父部门ID|string||
|
|||
|
|
|      parentName|父部门名称|string||
|
|||
|
|
|      phone|联系电话|string||
|
|||
|
|
|      status|部门状态|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    email|用户邮箱|string||
|
|||
|
|
|    loginDate|最后登录时间|string||
|
|||
|
|
|    loginIp|最后登录IP|string||
|
|||
|
|
|    nickName|用户昵称|string||
|
|||
|
|
|    password|密码|string||
|
|||
|
|
|    phonenumber|手机号码|string||
|
|||
|
|
|    postIds|岗位组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleIds|角色组|string||
|
|||
|
|
|    roles|角色对象|array|TenantRole对象|
|
|||
|
|
|      admin||boolean||
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|      deptIds|部门组(数据权限)|string||
|
|||
|
|
|      flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|      menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|      menuIds|菜单组|string||
|
|||
|
|
|      remark|备注|string||
|
|||
|
|
|      roleId|角色ID|string||
|
|||
|
|
|      roleKey|角色权限|string||
|
|||
|
|
|      roleName|角色名称|string||
|
|||
|
|
|      roleSort|角色排序|string||
|
|||
|
|
|      status|角色状态(0正常 1停用)|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    sex|用户性别|string||
|
|||
|
|
|    status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userId|用户ID|string||
|
|||
|
|
|    userName|用户账号|string||
|
|||
|
|
|    userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|  token||string||
|
|||
|
|
|  userid||integer(int64)||
|
|||
|
|
|  username||string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"customerUser": {
|
|||
|
|
"activeStatus": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userAddress": "",
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userImg": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userNickName": "",
|
|||
|
|
"userOpenId": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userPwd": "",
|
|||
|
|
"userSex": ""
|
|||
|
|
},
|
|||
|
|
"expireTime": 0,
|
|||
|
|
"ipaddr": "",
|
|||
|
|
"loginTime": 0,
|
|||
|
|
"tenantUser": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"token": "",
|
|||
|
|
"userid": 0,
|
|||
|
|
"username": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户注册
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/register`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"registerWay": "",
|
|||
|
|
"userImg": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userPwd": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|InsertCustomerDto|InsertCustomerDto|
|
|||
|
|
|  registerWay|注册方式{1:用户名 2:手机号}||false|string||
|
|||
|
|
|  userImg|用户头像||false|string||
|
|||
|
|
|  userName|用户名称,暂用手机号||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userPwd|用户密码||false|string||
|
|||
|
|
|tenant_id|tenant_id|header|true|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«boolean»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||boolean||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": true,
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 更新用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/updateAppUserById`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
[
|
|||
|
|
{
|
|||
|
|
"activeStatus": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userAddress": "",
|
|||
|
|
"userCardNo": "",
|
|||
|
|
"userCardType": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userImg": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userNickName": "",
|
|||
|
|
"userOpenId": "",
|
|||
|
|
"userPhone": "",
|
|||
|
|
"userPwd": "",
|
|||
|
|
"userSex": ""
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|customerUsers|customerUsers|body|true|array|CustomerUser|
|
|||
|
|
|  activeStatus|活跃状态,0:不活跃,1:活跃||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志;;0:未删除,1:已删除||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新者||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userAddress|用户注册地址||false|string||
|
|||
|
|
|  userCardNo|用户身份证号码||false|string||
|
|||
|
|
|  userCardType|用户证件类型(1:居民身份证,2:港澳台通行证)||false|string||
|
|||
|
|
|  userId|用户Id||false|string||
|
|||
|
|
|  userImg|用户头像||false|string||
|
|||
|
|
|  userName|用户名称||false|string||
|
|||
|
|
|  userNickName|用户昵称||false|string||
|
|||
|
|
|  userOpenId|用户微信ID||false|string||
|
|||
|
|
|  userPhone|用户手机号||false|string||
|
|||
|
|
|  userPwd|用户密码||false|string||
|
|||
|
|
|  userSex|用户性别(0:未知,1:男,2:女)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户信息修改
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/updateInfo`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"userId": 0,
|
|||
|
|
"userImg": "",
|
|||
|
|
"userNickName": "",
|
|||
|
|
"userSex": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|UpdateCustomerDto|UpdateCustomerDto|
|
|||
|
|
|  userId|用户Id||false|integer(int64)||
|
|||
|
|
|  userImg|用户头像||false|string||
|
|||
|
|
|  userNickName|用户昵称||false|string||
|
|||
|
|
|  userSex|用户性别||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改密码
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/updatePwd`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"newPwd": "",
|
|||
|
|
"oldPwd": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dto|dto|body|true|UpdatePwdDto|UpdatePwdDto|
|
|||
|
|
|  newPwd|新密码||false|string||
|
|||
|
|
|  oldPwd|原密码||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户信息详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/userInfo`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|appUserId|appUserId|path|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户信息详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/customerUser/front/userInfo/{appUserId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|appUserId|appUserId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 注册用户-运营后台
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 注销
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/customerUser/cancel`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userIds|userIds|query|false|array|integer|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询注册用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/customerUser/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createTimeDateEnd|注册时间止|query|false|string(date)||
|
|||
|
|
|createTimeStart|注册时间起|query|false|string(date)||
|
|||
|
|
|delFlag|用户状态用户状态{0:正常 1:注销}|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|用户名称|query|false|string||
|
|||
|
|
|userPhone|用户手机号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户信息详情
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/customerUser/{userId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userId|userId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-个人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取个人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/profile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改个人信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/profile`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|TenantUser对象|TenantUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|TenantDept对象|TenantDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|TenantDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|TenantRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户头像上传
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/profile/avatar`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`multipart/form-data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|avatarfile|avatarfile|formData|true|file||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 个人信息重置密码
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/profile/updatePwd`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|newPassword|newPassword|query|false|string||
|
|||
|
|
|oldPassword|oldPassword|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"noticeContent": "",
|
|||
|
|
"noticeId": "",
|
|||
|
|
"noticeTitle": "",
|
|||
|
|
"noticeType": "",
|
|||
|
|
"releaseMechanism": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|notice|通知公告表|body|true|TenantNotice对象|TenantNotice对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0:未删除,1:已删除)||false|string||
|
|||
|
|
|  fileName|附件名称||false|string||
|
|||
|
|
|  fileUrl|附件地址||false|string||
|
|||
|
|
|  noticeContent|公告内容||false|string||
|
|||
|
|
|  noticeId|公告ID||false|string||
|
|||
|
|
|  noticeTitle|公告标题||false|string||
|
|||
|
|
|  noticeType|公告类型(1:通知,2:公告)||false|string||
|
|||
|
|
|  releaseMechanism|发布机构||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|公告状态(0:正常,1:关闭)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"fileName": "",
|
|||
|
|
"fileUrl": "",
|
|||
|
|
"noticeContent": "",
|
|||
|
|
"noticeId": "",
|
|||
|
|
"noticeTitle": "",
|
|||
|
|
"noticeType": "",
|
|||
|
|
"releaseMechanism": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|notice|通知公告表|body|true|TenantNotice对象|TenantNotice对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0:未删除,1:已删除)||false|string||
|
|||
|
|
|  fileName|附件名称||false|string||
|
|||
|
|
|  fileUrl|附件地址||false|string||
|
|||
|
|
|  noticeContent|公告内容||false|string||
|
|||
|
|
|  noticeId|公告ID||false|string||
|
|||
|
|
|  noticeTitle|公告标题||false|string||
|
|||
|
|
|  noticeType|公告类型(1:通知,2:公告)||false|string||
|
|||
|
|
|  releaseMechanism|发布机构||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|公告状态(0:正常,1:关闭)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice/delete/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 管理端-获取通知公告列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0:未删除,1:已删除)|query|false|string||
|
|||
|
|
|fileName|附件名称|query|false|string||
|
|||
|
|
|fileUrl|附件地址|query|false|string||
|
|||
|
|
|noticeContent|公告内容|query|false|string||
|
|||
|
|
|noticeId|公告ID|query|false|integer(int64)||
|
|||
|
|
|noticeTitle|公告标题|query|false|string||
|
|||
|
|
|noticeType|公告类型(1:通知,2:公告)|query|false|string||
|
|||
|
|
|releaseMechanism|发布机构|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|公告状态(0:正常,1:关闭)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 下线通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice/offlineNotice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 上线通知公告
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice/onlineNotice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 管理端-根据通知公告编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/notice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-公告-门户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 门户-获取通知公告列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant/notice/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0:未删除,1:已删除)|query|false|string||
|
|||
|
|
|fileName|附件名称|query|false|string||
|
|||
|
|
|fileUrl|附件地址|query|false|string||
|
|||
|
|
|noticeContent|公告内容|query|false|string||
|
|||
|
|
|noticeId|公告ID|query|false|integer(int64)||
|
|||
|
|
|noticeTitle|公告标题|query|false|string||
|
|||
|
|
|noticeType|公告类型(1:通知,2:公告)|query|false|string||
|
|||
|
|
|releaseMechanism|发布机构|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|公告状态(0:正常,1:关闭)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 门户-根据通知公告编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/front/tenant/notice/{noticeId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|noticeId|noticeId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-在线用户监控
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询在线用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/online/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ipaddr|ipaddr|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|userName|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 强退用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/online/{tokenId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tokenId|tokenId|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"postCode": "",
|
|||
|
|
"postId": "",
|
|||
|
|
"postName": "",
|
|||
|
|
"postSort": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|post|岗位表|body|true|TenantPost对象|TenantPost对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  flag|用户是否存在此岗位标识 默认不存在||false|boolean||
|
|||
|
|
|  postCode|岗位编码||false|string||
|
|||
|
|
|  postId|岗位序号||false|string||
|
|||
|
|
|  postName|岗位名称||false|string||
|
|||
|
|
|  postSort|岗位排序||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"postCode": "",
|
|||
|
|
"postId": "",
|
|||
|
|
"postName": "",
|
|||
|
|
"postSort": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|post|岗位表|body|true|TenantPost对象|TenantPost对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  flag|用户是否存在此岗位标识 默认不存在||false|boolean||
|
|||
|
|
|  postCode|岗位编码||false|string||
|
|||
|
|
|  postId|岗位序号||false|string||
|
|||
|
|
|  postName|岗位名称||false|string||
|
|||
|
|
|  postSort|岗位排序||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出岗位列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|flag|用户是否存在此岗位标识 默认不存在|query|false|boolean||
|
|||
|
|
|postCode|岗位编码|query|false|string||
|
|||
|
|
|postId|岗位序号|query|false|integer(int64)||
|
|||
|
|
|postName|岗位名称|query|false|string||
|
|||
|
|
|postSort|岗位排序|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取岗位列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|flag|用户是否存在此岗位标识 默认不存在|query|false|boolean||
|
|||
|
|
|postCode|岗位编码|query|false|string||
|
|||
|
|
|postId|岗位序号|query|false|integer(int64)||
|
|||
|
|
|postName|岗位名称|query|false|string||
|
|||
|
|
|postSort|岗位排序|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取岗位选择框列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post/optionselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除岗位
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post/{postIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|postIds|postIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据岗位编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/post/{postId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|postId|postId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
## add
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/operlog`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"businessType": "",
|
|||
|
|
"businessTypes": [],
|
|||
|
|
"deptName": "",
|
|||
|
|
"errorMsg": "",
|
|||
|
|
"jsonResult": "",
|
|||
|
|
"method": "",
|
|||
|
|
"operId": "",
|
|||
|
|
"operIp": "",
|
|||
|
|
"operLocation": "",
|
|||
|
|
"operName": "",
|
|||
|
|
"operParam": "",
|
|||
|
|
"operTime": "",
|
|||
|
|
"operUrl": "",
|
|||
|
|
"operatorType": "",
|
|||
|
|
"requestMethod": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"title": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|operLog|操作日志记录表|body|true|TenantOperLog对象|TenantOperLog对象|
|
|||
|
|
|  businessType|业务类型(0:其它,1:新增, 2:修改,3:删除,4:授权,5:导出,6:导入,7:强退,8:生成代码,9:清空数据)||false|string||
|
|||
|
|
|  businessTypes|业务类型数组||false|array|string|
|
|||
|
|
|  deptName|部门名称||false|string||
|
|||
|
|
|  errorMsg|错误消息||false|string||
|
|||
|
|
|  jsonResult|返回参数||false|string||
|
|||
|
|
|  method|请求方法||false|string||
|
|||
|
|
|  operId|日志主键||false|string||
|
|||
|
|
|  operIp|操作地址||false|string||
|
|||
|
|
|  operLocation|操作地点||false|string||
|
|||
|
|
|  operName|操作人员||false|string||
|
|||
|
|
|  operParam|请求参数||false|string||
|
|||
|
|
|  operTime|操作时间||false|string(date-time)||
|
|||
|
|
|  operUrl|请求URL||false|string||
|
|||
|
|
|  operatorType|操作类别(0:其它,1:后台用户,2:手机端用户)||false|string||
|
|||
|
|
|  requestMethod|请求方式||false|string||
|
|||
|
|
|  status|操作状态(0:正常,1:异常)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  title|操作模块||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 清除日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/operlog/clean`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/operlog/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|业务类型(0:其它,1:新增, 2:修改,3:删除,4:授权,5:导出,6:导入,7:强退,8:生成代码,9:清空数据)|query|false|string||
|
|||
|
|
|businessTypes|业务类型数组|query|false|array|string|
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|errorMsg|错误消息|query|false|string||
|
|||
|
|
|jsonResult|返回参数|query|false|string||
|
|||
|
|
|method|请求方法|query|false|string||
|
|||
|
|
|operId|日志主键|query|false|integer(int64)||
|
|||
|
|
|operIp|操作地址|query|false|string||
|
|||
|
|
|operLocation|操作地点|query|false|string||
|
|||
|
|
|operName|操作人员|query|false|string||
|
|||
|
|
|operParam|请求参数|query|false|string||
|
|||
|
|
|operTime|操作时间|query|false|string(date-time)||
|
|||
|
|
|operUrl|请求URL|query|false|string||
|
|||
|
|
|operatorType|操作类别(0:其它,1:后台用户,2:手机端用户)|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|requestMethod|请求方式|query|false|string||
|
|||
|
|
|status|操作状态(0:正常,1:异常)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|title|操作模块|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 日志列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/operlog/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|businessType|业务类型(0:其它,1:新增, 2:修改,3:删除,4:授权,5:导出,6:导入,7:强退,8:生成代码,9:清空数据)|query|false|string||
|
|||
|
|
|businessTypes|业务类型数组|query|false|array|string|
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|errorMsg|错误消息|query|false|string||
|
|||
|
|
|jsonResult|返回参数|query|false|string||
|
|||
|
|
|method|请求方法|query|false|string||
|
|||
|
|
|operId|日志主键|query|false|integer(int64)||
|
|||
|
|
|operIp|操作地址|query|false|string||
|
|||
|
|
|operLocation|操作地点|query|false|string||
|
|||
|
|
|operName|操作人员|query|false|string||
|
|||
|
|
|operParam|请求参数|query|false|string||
|
|||
|
|
|operTime|操作时间|query|false|string(date-time)||
|
|||
|
|
|operUrl|请求URL|query|false|string||
|
|||
|
|
|operatorType|操作类别(0:其它,1:后台用户,2:手机端用户)|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|requestMethod|请求方式|query|false|string||
|
|||
|
|
|status|操作状态(0:正常,1:异常)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|title|操作模块|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/operlog/{operIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|operIds|operIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|TenantUser对象|TenantUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|TenantDept对象|TenantDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|TenantDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|TenantRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|TenantUser对象|TenantUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|TenantDept对象|TenantDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|TenantDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|TenantRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|userId|path|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户授权角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/authRole`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleIds|roleIds|query|false|array|integer|
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userId|userId|query|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户编号获取授权角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/authRole/{userId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userId|userId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户状态修改
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/changeStatus/{id}/{status}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|id|id|path|true|integer(int64)||
|
|||
|
|
|status|status|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/getInfo`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据租户账号获取租户昵称
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/getNickNameByUsername/{username}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|username|username|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«string»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": "",
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取当前用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/getTenantUser`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«TenantUser对象»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||TenantUser对象|TenantUser对象|
|
|||
|
|
|  admin||boolean||
|
|||
|
|
|  avatar|用户头像|string||
|
|||
|
|
|  createBy|创建人|string||
|
|||
|
|
|  createTime|创建时间|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|  dept|部门对象|TenantDept对象|TenantDept对象|
|
|||
|
|
|    ancestors|祖级列表|string||
|
|||
|
|
|    children|子部门|array|TenantDept对象|
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    deptName|部门名称|string||
|
|||
|
|
|    deptType|部门类型|string||
|
|||
|
|
|    email|邮箱|string||
|
|||
|
|
|    leader|负责人|string||
|
|||
|
|
|    orderNum|显示顺序|string||
|
|||
|
|
|    parentId|父部门ID|string||
|
|||
|
|
|    parentName|父部门名称|string||
|
|||
|
|
|    phone|联系电话|string||
|
|||
|
|
|    status|部门状态|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|  deptId|部门ID|string||
|
|||
|
|
|  email|用户邮箱|string||
|
|||
|
|
|  loginDate|最后登录时间|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP|string||
|
|||
|
|
|  nickName|用户昵称|string||
|
|||
|
|
|  password|密码|string||
|
|||
|
|
|  phonenumber|手机号码|string||
|
|||
|
|
|  postIds|岗位组|string||
|
|||
|
|
|  remark|备注|string||
|
|||
|
|
|  roleId|角色ID|string||
|
|||
|
|
|  roleIds|角色组|string||
|
|||
|
|
|  roles|角色对象|array|TenantRole对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|    menuIds|菜单组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleKey|角色权限|string||
|
|||
|
|
|    roleName|角色名称|string||
|
|||
|
|
|    roleSort|角色排序|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|  sex|用户性别|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|  tenantId|租户ID|string||
|
|||
|
|
|  updateBy|更新人|string||
|
|||
|
|
|  updateTime|更新时间|string(date-time)||
|
|||
|
|
|  userId|用户ID|string||
|
|||
|
|
|  userName|用户账号|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导入用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/importData`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`multipart/form-data`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|file|file|formData|false|file||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateSupport|updateSupport|query|false|boolean||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导入模板
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/importTemplate`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取当前用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/info/{username}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|username|username|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«LoginUser»|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||LoginUser|LoginUser|
|
|||
|
|
|  expireTime||integer(int64)||
|
|||
|
|
|  ipaddr||string||
|
|||
|
|
|  loginTime||integer(int64)||
|
|||
|
|
|  permissions||array|string|
|
|||
|
|
|  roles||array|string|
|
|||
|
|
|  sysUser||SysUser对象|SysUser对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    avatar|用户头像|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    dept|部门对象|SysDept对象|SysDept对象|
|
|||
|
|
|      ancestors|祖级列表|string||
|
|||
|
|
|      children|子部门|array|SysDept对象|
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptId|部门ID|string||
|
|||
|
|
|      deptName|部门名称|string||
|
|||
|
|
|      deptType|部门类型|string||
|
|||
|
|
|      email|邮箱|string||
|
|||
|
|
|      leader|负责人|string||
|
|||
|
|
|      orderNum|显示顺序|string||
|
|||
|
|
|      parentId|父部门ID|string||
|
|||
|
|
|      parentName|父部门名称|string||
|
|||
|
|
|      phone|联系电话|string||
|
|||
|
|
|      status|部门状态|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    email|用户邮箱|string||
|
|||
|
|
|    loginDate|最后登录时间|string||
|
|||
|
|
|    loginIp|最后登录IP|string||
|
|||
|
|
|    nickName|用户昵称|string||
|
|||
|
|
|    password|密码|string||
|
|||
|
|
|    phonenumber|手机号码|string||
|
|||
|
|
|    postIds|岗位组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleIds|角色组|string||
|
|||
|
|
|    roles|角色对象|array|SysRole对象|
|
|||
|
|
|      admin||boolean||
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|      deptIds|部门组(数据权限)|string||
|
|||
|
|
|      flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|      menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|      menuIds|菜单组|string||
|
|||
|
|
|      remark|备注|string||
|
|||
|
|
|      roleId|角色ID|string||
|
|||
|
|
|      roleKey|角色权限|string||
|
|||
|
|
|      roleName|角色名称|string||
|
|||
|
|
|      roleSort|角色排序|string||
|
|||
|
|
|      status|角色状态(0正常 1停用)|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    sex|用户性别|string||
|
|||
|
|
|    status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userId|用户ID|string||
|
|||
|
|
|    userName|用户账号|string||
|
|||
|
|
|    userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|  tenantUser||TenantUser对象|TenantUser对象|
|
|||
|
|
|    admin||boolean||
|
|||
|
|
|    avatar|用户头像|string||
|
|||
|
|
|    createBy|创建人|string||
|
|||
|
|
|    createTime|创建时间|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|    dept|部门对象|TenantDept对象|TenantDept对象|
|
|||
|
|
|      ancestors|祖级列表|string||
|
|||
|
|
|      children|子部门|array|TenantDept对象|
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptId|部门ID|string||
|
|||
|
|
|      deptName|部门名称|string||
|
|||
|
|
|      deptType|部门类型|string||
|
|||
|
|
|      email|邮箱|string||
|
|||
|
|
|      leader|负责人|string||
|
|||
|
|
|      orderNum|显示顺序|string||
|
|||
|
|
|      parentId|父部门ID|string||
|
|||
|
|
|      parentName|父部门名称|string||
|
|||
|
|
|      phone|联系电话|string||
|
|||
|
|
|      status|部门状态|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    deptId|部门ID|string||
|
|||
|
|
|    email|用户邮箱|string||
|
|||
|
|
|    loginDate|最后登录时间|string||
|
|||
|
|
|    loginIp|最后登录IP|string||
|
|||
|
|
|    nickName|用户昵称|string||
|
|||
|
|
|    password|密码|string||
|
|||
|
|
|    phonenumber|手机号码|string||
|
|||
|
|
|    postIds|岗位组|string||
|
|||
|
|
|    remark|备注|string||
|
|||
|
|
|    roleId|角色ID|string||
|
|||
|
|
|    roleIds|角色组|string||
|
|||
|
|
|    roles|角色对象|array|TenantRole对象|
|
|||
|
|
|      admin||boolean||
|
|||
|
|
|      createBy|创建人|string||
|
|||
|
|
|      createTime|创建时间|string||
|
|||
|
|
|      dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|string||
|
|||
|
|
|      delFlag|删除标志(0代表存在 2代表删除)|string||
|
|||
|
|
|      deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|boolean||
|
|||
|
|
|      deptIds|部门组(数据权限)|string||
|
|||
|
|
|      flag|用户是否存在此角色标识 默认不存在|boolean||
|
|||
|
|
|      menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|boolean||
|
|||
|
|
|      menuIds|菜单组|string||
|
|||
|
|
|      remark|备注|string||
|
|||
|
|
|      roleId|角色ID|string||
|
|||
|
|
|      roleKey|角色权限|string||
|
|||
|
|
|      roleName|角色名称|string||
|
|||
|
|
|      roleSort|角色排序|string||
|
|||
|
|
|      status|角色状态(0正常 1停用)|string||
|
|||
|
|
|      tenantId|租户ID|string||
|
|||
|
|
|      updateBy|更新人|string||
|
|||
|
|
|      updateTime|更新时间|string||
|
|||
|
|
|    sex|用户性别|string||
|
|||
|
|
|    status|帐号状态(0正常 1停用)|string||
|
|||
|
|
|    tenantId|租户ID|string||
|
|||
|
|
|    updateBy|更新人|string||
|
|||
|
|
|    updateTime|更新时间|string||
|
|||
|
|
|    userId|用户ID|string||
|
|||
|
|
|    userName|用户账号|string||
|
|||
|
|
|    userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|string||
|
|||
|
|
|  token||string||
|
|||
|
|
|  userid||integer(int64)||
|
|||
|
|
|  username||string||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {
|
|||
|
|
"expireTime": 0,
|
|||
|
|
"ipaddr": "",
|
|||
|
|
"loginTime": 0,
|
|||
|
|
"permissions": [],
|
|||
|
|
"roles": [],
|
|||
|
|
"sysUser": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"tenantUser": {
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
},
|
|||
|
|
"token": "",
|
|||
|
|
"userid": 0,
|
|||
|
|
"username": ""
|
|||
|
|
},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询部门用户列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/listByDept/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 注册用户信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/register`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|TenantUser|用户对象|body|true|TenantUser对象|TenantUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|TenantDept对象|TenantDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|TenantDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|TenantRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|R«boolean»|
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|data||boolean||
|
|||
|
|
|msg||string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": true,
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 用户重置密码
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/resetPwd`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"avatar": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"dept": {
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
},
|
|||
|
|
"deptId": "",
|
|||
|
|
"email": "",
|
|||
|
|
"loginDate": "",
|
|||
|
|
"loginIp": "",
|
|||
|
|
"nickName": "",
|
|||
|
|
"password": "",
|
|||
|
|
"phonenumber": "",
|
|||
|
|
"postIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleIds": "",
|
|||
|
|
"roles": [
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"sex": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"userId": "",
|
|||
|
|
"userName": "",
|
|||
|
|
"userType": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|user|用户对象|body|true|TenantUser对象|TenantUser对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  avatar|用户头像||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  dept|部门对象||false|TenantDept对象|TenantDept对象|
|
|||
|
|
|    ancestors|祖级列表||false|string||
|
|||
|
|
|    children|子部门||false|array|TenantDept对象|
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptId|部门ID||false|string||
|
|||
|
|
|    deptName|部门名称||false|string||
|
|||
|
|
|    deptType|部门类型||false|string||
|
|||
|
|
|    email|邮箱||false|string||
|
|||
|
|
|    leader|负责人||false|string||
|
|||
|
|
|    orderNum|显示顺序||false|string||
|
|||
|
|
|    parentId|父部门ID||false|string||
|
|||
|
|
|    parentName|父部门名称||false|string||
|
|||
|
|
|    phone|联系电话||false|string||
|
|||
|
|
|    status|部门状态||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  email|用户邮箱||false|string||
|
|||
|
|
|  loginDate|最后登录时间||false|string(date-time)||
|
|||
|
|
|  loginIp|最后登录IP||false|string||
|
|||
|
|
|  nickName|用户昵称||false|string||
|
|||
|
|
|  password|密码||false|string||
|
|||
|
|
|  phonenumber|手机号码||false|string||
|
|||
|
|
|  postIds|岗位组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleIds|角色组||false|string||
|
|||
|
|
|  roles|角色对象||false|array|TenantRole对象|
|
|||
|
|
|    admin|||false|boolean||
|
|||
|
|
|    createBy|创建人||false|string||
|
|||
|
|
|    createTime|创建时间||false|string||
|
|||
|
|
|    dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|    delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|    deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|    deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|    flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|    menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|    menuIds|菜单组||false|string||
|
|||
|
|
|    remark|备注||false|string||
|
|||
|
|
|    roleId|角色ID||false|string||
|
|||
|
|
|    roleKey|角色权限||false|string||
|
|||
|
|
|    roleName|角色名称||false|string||
|
|||
|
|
|    roleSort|角色排序||false|string||
|
|||
|
|
|    status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|    tenantId|租户ID||false|string||
|
|||
|
|
|    updateBy|更新人||false|string||
|
|||
|
|
|    updateTime|更新时间||false|string||
|
|||
|
|
|  sex|用户性别||false|string||
|
|||
|
|
|  status|帐号状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|  userType|用户类型(00:系统用户,01:注册用户,02:租户超管)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/{userIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userIds|userIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据用户编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/user/{userId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userId|userId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-登录日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
## add
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/logininfor`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"accessTime": "",
|
|||
|
|
"infoId": "",
|
|||
|
|
"ipaddr": "",
|
|||
|
|
"msg": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"userName": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|logininfor|系统访问记录表|body|true|TenantLogininfor对象|TenantLogininfor对象|
|
|||
|
|
|  accessTime|访问时间||false|string(date-time)||
|
|||
|
|
|  infoId|ID||false|string||
|
|||
|
|
|  ipaddr|地址||false|string||
|
|||
|
|
|  msg|描述||false|string||
|
|||
|
|
|  status|状态(0:成功,1:失败)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  userName|用户账号||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 清除登录日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/logininfor/clean`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出登录日志列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/logininfor/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|accessTime|访问时间|query|false|string(date-time)||
|
|||
|
|
|infoId|ID|query|false|integer(int64)||
|
|||
|
|
|ipaddr|地址|query|false|string||
|
|||
|
|
|msg|描述|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|status|状态(0:成功,1:失败)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询登录日志列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/logininfor/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|accessTime|访问时间|query|false|string(date-time)||
|
|||
|
|
|infoId|ID|query|false|integer(int64)||
|
|||
|
|
|ipaddr|地址|query|false|string||
|
|||
|
|
|msg|描述|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|status|状态(0:成功,1:失败)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除登录日志
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/logininfor/{infoIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|infoIds|infoIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"children": [],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menu|菜单权限表|body|true|TenantMenu对象|TenantMenu对象|
|
|||
|
|
|  children|子菜单||false|array|TenantMenu对象|
|
|||
|
|
|  component|组件路径||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  icon|菜单图标||false|string||
|
|||
|
|
|  isCache|是否缓存(0缓存 1不缓存)||false|string||
|
|||
|
|
|  isFrame|是否为外链(0是 1否)||false|string||
|
|||
|
|
|  menuId|菜单ID||false|string||
|
|||
|
|
|  menuName|菜单名称||false|string||
|
|||
|
|
|  menuType|类型(M目录 C菜单 F按钮)||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父菜单ID||false|string||
|
|||
|
|
|  parentName|父菜单名称||false|string||
|
|||
|
|
|  path|路由地址||false|string||
|
|||
|
|
|  perms|权限字符串||false|string||
|
|||
|
|
|  query|路由参数||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|菜单状态(0显示 1隐藏)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  visible|显示状态(0显示 1隐藏)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"children": [],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"component": "",
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"icon": "",
|
|||
|
|
"isCache": "",
|
|||
|
|
"isFrame": "",
|
|||
|
|
"menuId": "",
|
|||
|
|
"menuName": "",
|
|||
|
|
"menuType": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"path": "",
|
|||
|
|
"perms": "",
|
|||
|
|
"query": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"status": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": "",
|
|||
|
|
"visible": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menu|菜单权限表|body|true|TenantMenu对象|TenantMenu对象|
|
|||
|
|
|  children|子菜单||false|array|TenantMenu对象|
|
|||
|
|
|  component|组件路径||false|string||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  icon|菜单图标||false|string||
|
|||
|
|
|  isCache|是否缓存(0缓存 1不缓存)||false|string||
|
|||
|
|
|  isFrame|是否为外链(0是 1否)||false|string||
|
|||
|
|
|  menuId|菜单ID||false|string||
|
|||
|
|
|  menuName|菜单名称||false|string||
|
|||
|
|
|  menuType|类型(M目录 C菜单 F按钮)||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父菜单ID||false|string||
|
|||
|
|
|  parentName|父菜单名称||false|string||
|
|||
|
|
|  path|路由地址||false|string||
|
|||
|
|
|  perms|权限字符串||false|string||
|
|||
|
|
|  query|路由参数||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  status|菜单状态(0显示 1隐藏)||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|  visible|显示状态(0显示 1隐藏)||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取路由信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu/getRouters`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取菜单列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|component|组件路径|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|icon|菜单图标|query|false|string||
|
|||
|
|
|isCache|是否缓存(0缓存 1不缓存)|query|false|string||
|
|||
|
|
|isFrame|是否为外链(0是 1否)|query|false|string||
|
|||
|
|
|menuId|菜单ID|query|false|integer(int64)||
|
|||
|
|
|menuName|菜单名称|query|false|string||
|
|||
|
|
|menuType|类型(M目录 C菜单 F按钮)|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父菜单ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父菜单名称|query|false|string||
|
|||
|
|
|path|路由地址|query|false|string||
|
|||
|
|
|perms|权限字符串|query|false|string||
|
|||
|
|
|query|路由参数|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|菜单状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|visible|显示状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 加载对应角色菜单列表树
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu/roleMenuTreeselect/{roleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取菜单下拉树列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu/treeselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|component|组件路径|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|icon|菜单图标|query|false|string||
|
|||
|
|
|isCache|是否缓存(0缓存 1不缓存)|query|false|string||
|
|||
|
|
|isFrame|是否为外链(0是 1否)|query|false|string||
|
|||
|
|
|menuId|菜单ID|query|false|integer(int64)||
|
|||
|
|
|menuName|菜单名称|query|false|string||
|
|||
|
|
|menuType|类型(M目录 C菜单 F按钮)|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父菜单ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父菜单名称|query|false|string||
|
|||
|
|
|path|路由地址|query|false|string||
|
|||
|
|
|perms|权限字符串|query|false|string||
|
|||
|
|
|query|路由参数|query|false|string||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|status|菜单状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|visible|显示状态(0显示 1隐藏)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据菜单编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu/{menuId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menuId|menuId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除菜单
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/menu/{menuId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|menuId|menuId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|role|角色表|body|true|TenantRole对象|TenantRole对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|  deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|  flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|  menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|  menuIds|菜单组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleKey|角色权限||false|string||
|
|||
|
|
|  roleName|角色名称||false|string||
|
|||
|
|
|  roleSort|角色排序||false|string||
|
|||
|
|
|  status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|role|角色表|body|true|TenantRole对象|TenantRole对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|  deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|  flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|  menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|  menuIds|菜单组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleKey|角色权限||false|string||
|
|||
|
|
|  roleName|角色名称||false|string||
|
|||
|
|
|  roleSort|角色排序||false|string||
|
|||
|
|
|  status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询已分配用户角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/authUser/allocatedList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 取消授权用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/authUser/cancel`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"roleId": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"userId": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|userRole|用户和角色关联|body|true|TenantUserRole对象|TenantUserRole对象|
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  userId|用户ID||false|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量取消授权用户
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/authUser/cancelAll`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userIds|userIds|query|false|array|integer|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 批量选择用户授权
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/authUser/selectAll`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|userIds|userIds|query|false|array|integer|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询未分配用户角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/authUser/unallocatedList`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|avatar|用户头像|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.ancestors|祖级列表|query|false|string||
|
|||
|
|
|dept.createBy|创建人|query|false|string||
|
|||
|
|
|dept.createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dept.delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|dept.deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.deptName|部门名称|query|false|string||
|
|||
|
|
|dept.deptType|部门类型|query|false|string||
|
|||
|
|
|dept.email|邮箱|query|false|string||
|
|||
|
|
|dept.leader|负责人|query|false|string||
|
|||
|
|
|dept.orderNum|显示顺序|query|false|string||
|
|||
|
|
|dept.parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|dept.parentName|父部门名称|query|false|string||
|
|||
|
|
|dept.phone|联系电话|query|false|string||
|
|||
|
|
|dept.status|部门状态|query|false|string||
|
|||
|
|
|dept.tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|dept.updateBy|更新人|query|false|string||
|
|||
|
|
|dept.updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|email|用户邮箱|query|false|string||
|
|||
|
|
|loginDate|最后登录时间|query|false|string(date-time)||
|
|||
|
|
|loginIp|最后登录IP|query|false|string||
|
|||
|
|
|nickName|用户昵称|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|password|密码|query|false|string||
|
|||
|
|
|phonenumber|手机号码|query|false|string||
|
|||
|
|
|postIds|岗位组|query|false|array|integer|
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleIds|角色组|query|false|array|integer|
|
|||
|
|
|roles[0].admin||query|false|boolean||
|
|||
|
|
|roles[0].createBy|创建人|query|false|string||
|
|||
|
|
|roles[0].createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|roles[0].dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|roles[0].delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|roles[0].deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|roles[0].deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|roles[0].flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|roles[0].menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|roles[0].menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|roles[0].remark|备注|query|false|string||
|
|||
|
|
|roles[0].roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].roleKey|角色权限|query|false|string||
|
|||
|
|
|roles[0].roleName|角色名称|query|false|string||
|
|||
|
|
|roles[0].roleSort|角色排序|query|false|string||
|
|||
|
|
|roles[0].status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|roles[0].tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|roles[0].updateBy|更新人|query|false|string||
|
|||
|
|
|roles[0].updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|sex|用户性别|query|false|string||
|
|||
|
|
|status|帐号状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|userId|用户ID|query|false|integer(int64)||
|
|||
|
|
|userName|用户账号|query|false|string||
|
|||
|
|
|userType|用户类型(00:系统用户,01:注册用户,02:租户超管)|query|false|string||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改保存数据权限
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/dataScope`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"admin": true,
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"dataScope": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptCheckStrictly": true,
|
|||
|
|
"deptIds": "",
|
|||
|
|
"flag": true,
|
|||
|
|
"menuCheckStrictly": true,
|
|||
|
|
"menuIds": "",
|
|||
|
|
"remark": "",
|
|||
|
|
"roleId": "",
|
|||
|
|
"roleKey": "",
|
|||
|
|
"roleName": "",
|
|||
|
|
"roleSort": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|role|角色表|body|true|TenantRole对象|TenantRole对象|
|
|||
|
|
|  admin|||false|boolean||
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)||false|string||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )||false|boolean||
|
|||
|
|
|  deptIds|部门组(数据权限)||false|string||
|
|||
|
|
|  flag|用户是否存在此角色标识 默认不存在||false|boolean||
|
|||
|
|
|  menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)||false|boolean||
|
|||
|
|
|  menuIds|菜单组||false|string||
|
|||
|
|
|  remark|备注||false|string||
|
|||
|
|
|  roleId|角色ID||false|string||
|
|||
|
|
|  roleKey|角色权限||false|string||
|
|||
|
|
|  roleName|角色名称||false|string||
|
|||
|
|
|  roleSort|角色排序||false|string||
|
|||
|
|
|  status|角色状态(0正常 1停用)||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 导出角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/export`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleKey|角色权限|query|false|string||
|
|||
|
|
|roleName|角色名称|query|false|string||
|
|||
|
|
|roleSort|角色排序|query|false|string||
|
|||
|
|
|status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询角色列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|admin||query|false|boolean||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|dataScope|数据范围(1:所有数据权限;2:自定义数据权限;3:本部门数据权限;4:本部门及以下数据权限;5:仅本人数据权限)|query|false|string||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptCheckStrictly|部门树选择项是否关联显示(0:父子不互相关联显示 1:父子互相关联显示 )|query|false|boolean||
|
|||
|
|
|deptIds|部门组(数据权限)|query|false|array|integer|
|
|||
|
|
|flag|用户是否存在此角色标识 默认不存在|query|false|boolean||
|
|||
|
|
|menuCheckStrictly|菜单树选择项是否关联显示( 0:父子不互相关联显示 1:父子互相关联显示)|query|false|boolean||
|
|||
|
|
|menuIds|菜单组|query|false|array|integer|
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|remark|备注|query|false|string||
|
|||
|
|
|roleId|角色ID|query|false|integer(int64)||
|
|||
|
|
|roleKey|角色权限|query|false|string||
|
|||
|
|
|roleName|角色名称|query|false|string||
|
|||
|
|
|roleSort|角色排序|query|false|string||
|
|||
|
|
|status|角色状态(0正常 1停用)|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK|TableDataInfo|
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 类型 | schema |
|
|||
|
|
| -------- | -------- | ----- |----- |
|
|||
|
|
|code||integer(int32)|integer(int32)|
|
|||
|
|
|msg||string||
|
|||
|
|
|rows||array||
|
|||
|
|
|total||integer(int64)|integer(int64)|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"msg": "",
|
|||
|
|
"rows": [],
|
|||
|
|
"total": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取角色选择框列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/optionselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除角色
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/{roleIds}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleIds|roleIds|path|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据角色编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/role/{roleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 租户-部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 新增部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`POST`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dept|部门表|body|true|TenantDept对象|TenantDept对象|
|
|||
|
|
|  ancestors|祖级列表||false|string||
|
|||
|
|
|  children|子部门||false|array|TenantDept对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  deptName|部门名称||false|string||
|
|||
|
|
|  deptType|部门类型||false|string||
|
|||
|
|
|  email|邮箱||false|string||
|
|||
|
|
|  leader|负责人||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父部门ID||false|string||
|
|||
|
|
|  parentName|父部门名称||false|string||
|
|||
|
|
|  phone|联系电话||false|string||
|
|||
|
|
|  status|部门状态||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 修改部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`PUT`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/json`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求示例**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"ancestors": "",
|
|||
|
|
"children": [
|
|||
|
|
{}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"createBy": "",
|
|||
|
|
"createTime": "",
|
|||
|
|
"delFlag": "",
|
|||
|
|
"deptId": "",
|
|||
|
|
"deptName": "",
|
|||
|
|
"deptType": "",
|
|||
|
|
"email": "",
|
|||
|
|
"leader": "",
|
|||
|
|
"orderNum": "",
|
|||
|
|
"parentId": "",
|
|||
|
|
"parentName": "",
|
|||
|
|
"phone": "",
|
|||
|
|
"status": "",
|
|||
|
|
"tenantId": "",
|
|||
|
|
"updateBy": "",
|
|||
|
|
"updateTime": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|dept|部门表|body|true|TenantDept对象|TenantDept对象|
|
|||
|
|
|  ancestors|祖级列表||false|string||
|
|||
|
|
|  children|子部门||false|array|TenantDept对象|
|
|||
|
|
|  createBy|创建人||false|string||
|
|||
|
|
|  createTime|创建时间||false|string(date-time)||
|
|||
|
|
|  delFlag|删除标志(0代表存在 2代表删除)||false|string||
|
|||
|
|
|  deptId|部门ID||false|string||
|
|||
|
|
|  deptName|部门名称||false|string||
|
|||
|
|
|  deptType|部门类型||false|string||
|
|||
|
|
|  email|邮箱||false|string||
|
|||
|
|
|  leader|负责人||false|string||
|
|||
|
|
|  orderNum|显示顺序||false|string||
|
|||
|
|
|  parentId|父部门ID||false|string||
|
|||
|
|
|  parentName|父部门名称||false|string||
|
|||
|
|
|  phone|联系电话||false|string||
|
|||
|
|
|  status|部门状态||false|string||
|
|||
|
|
|  tenantId|租户ID||false|string||
|
|||
|
|
|  updateBy|更新人||false|string||
|
|||
|
|
|  updateTime|更新时间||false|string(date-time)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|201|Created||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取部门下拉树列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/getNormalDeptTree`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取部门列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/list`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ancestors|祖级列表|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|deptType|部门类型|query|false|string||
|
|||
|
|
|email|邮箱|query|false|string||
|
|||
|
|
|leader|负责人|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父部门名称|query|false|string||
|
|||
|
|
|phone|联系电话|query|false|string||
|
|||
|
|
|status|部门状态|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 查询部门列表(排除节点)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/list/exclude/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 加载对应角色部门列表树
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/roleDeptTreeselect/{roleId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|roleId|roleId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 获取部门下拉树列表
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/treeselect`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|ancestors|祖级列表|query|false|string||
|
|||
|
|
|createBy|创建人|query|false|string||
|
|||
|
|
|createTime|创建时间|query|false|string(date-time)||
|
|||
|
|
|delFlag|删除标志(0代表存在 2代表删除)|query|false|string||
|
|||
|
|
|deptId|部门ID|query|false|integer(int64)||
|
|||
|
|
|deptName|部门名称|query|false|string||
|
|||
|
|
|deptType|部门类型|query|false|string||
|
|||
|
|
|email|邮箱|query|false|string||
|
|||
|
|
|leader|负责人|query|false|string||
|
|||
|
|
|orderNum|显示顺序|query|false|string||
|
|||
|
|
|params|请求参数|query|false|object||
|
|||
|
|
|parentId|父部门ID|query|false|integer(int64)||
|
|||
|
|
|parentName|父部门名称|query|false|string||
|
|||
|
|
|phone|联系电话|query|false|string||
|
|||
|
|
|status|部门状态|query|false|string||
|
|||
|
|
|tenantId|租户ID|query|false|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|updateBy|更新人|query|false|string||
|
|||
|
|
|updateTime|更新时间|query|false|string(date-time)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 根据部门编号获取详细信息
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`GET`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|404|Not Found||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 删除部门
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口地址**:`/system/tenant/dept/{deptId}`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求方式**:`DELETE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求数据类型**:`application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应数据类型**:`*/*`
|
|||
|
|
|
|||
|
|
|
|||
|
|
**接口描述**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**请求参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|
|||
|
|
| -------- | -------- | ----- | -------- | -------- | ------ |
|
|||
|
|
|Authorization|鉴权认证|header|true|string||
|
|||
|
|
|deptId|deptId|path|true|integer(int64)||
|
|||
|
|
|tenant_id|租户ID|header|false|integer(int64)||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应状态**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
| 状态码 | 说明 | schema |
|
|||
|
|
| -------- | -------- | ----- |
|
|||
|
|
|200|OK||
|
|||
|
|
|204|No Content||
|
|||
|
|
|401|Unauthorized||
|
|||
|
|
|403|Forbidden||
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应参数**:
|
|||
|
|
|
|||
|
|
|
|||
|
|
暂无
|
|||
|
|
|
|||
|
|
|
|||
|
|
**响应示例**:
|
|||
|
|
```javascript
|
|||
|
|
|
|||
|
|
```
|