Files
obsidian_note/各种项目/咪咕/api接口文档/SaaS.md

38328 lines
752 KiB
Markdown
Raw Normal View History

2025-12-04 09:12:56 +08:00
# 认证模块接口文档
**简介**:系统模块接口文档
**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|权益说明;01||false|string||
|  businessTypes|支持的项目||false|string||
|  buyNotice|购买须知||false|string||
|  endNo|会员卡号结束||false|integer(int64)||
|  fieldIds|支持的场地||false|string||
|  isRealAuth|是否实名制购卡;01||false|string||
|  isSelf|是否仅限本人使用;01||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|权益说明;01||false|string||
|  businessTypes|支持的项目||false|string||
|  buyNotice|购买须知||false|string||
|  endNo|会员卡号结束||false|integer(int64)||
|  fieldIds|支持的场地||false|string||
|  isRealAuth|是否实名制购卡;01||false|string||
|  isSelf|是否仅限本人使用;01||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|是否最新审核记录;01|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|是否允许评论;01||false|string||
|  isPraise|是否允许点赞;01||false|string||
|  isTop|是否置顶;01||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|是否允许评论;01||false|string||
|  isPraise|是否允许点赞;01||false|string||
|  isTop|是否置顶;01||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|是否置顶;01|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|是否置顶;01|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|是否购票;01||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|是否允许退订;01||false|string||
|  isRefundApproval|退订是否需审核;01||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|是否允许退订;01||false|string||
|  isRefundApproval|退订是否需审核;01||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|是否允许评论;01||false|string||
|  isPraise|是否允许点赞;01||false|string||
|  isTop|是否置顶;01||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|是否允许评论;01||false|string||
|  isPraise|是否允许点赞;01||false|string||
|  isTop|是否置顶;01||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|是否购票;01||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|是否购票;01||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|是否购票;01|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|是否购票;01|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|是否最新审核记录;01|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|是否允许评论;01||false|string||
|  isPraise|是否允许点赞;01||false|string||
|  isTop|是否置顶;01||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|是否允许评论;01||false|string||
|  isPraise|是否允许点赞;01||false|string||
|  isTop|是否置顶;01||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|是否置顶;01|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|是否置顶;01|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|是否购票;01||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|退订状态;01是 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|退订状态;01是 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
```