---
title: Web开发-AI
language_tabs:
  - shell: Shell
  - http: HTTP
  - javascript: JavaScript
  - ruby: Ruby
  - python: Python
  - php: PHP
  - java: Java
  - go: Go
toc_footers: []
includes: []
search: true
code_clipboard: true
highlight_theme: darkula
headingLevel: 2
generator: "@tarslib/widdershins v4.0.30"

---

# Web开发-AI

新版本的Web开发的接口文档

Base URLs:

# Authentication

# 班级管理

<a id="opIdpageUsingGET"></a>

## GET 分页查询

GET /clazzs

班级信息的分页条件查询

### 请求参数

|名称|位置|类型|必选|说明|
|---|---|---|---|---|
|name|query|string| 否 |班级名称|
|begin|query|string| 否 |结课时间的开始时间|
|end|query|string| 否 |结课时间的结束时间|
|page|query|integer| 否 |页码|
|pageSize|query|integer| 否 |每页展示记录数|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {
    "total": 0,
    "rows": [
      {
        "id": 0,
        "name": "string",
        "room": "string",
        "beginDate": "2019-08-24",
        "endDate": "2019-08-24",
        "masterId": 0,
        "masterName": "string",
        "subject": 0,
        "createTime": "2019-08-24T14:15:22Z",
        "updateTime": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|
|»» total|integer|true|none|总记录数|总记录数|
|»» rows|[object]|true|none|结果列表|结果列表|
|»»» id|integer(int32)|false|none|ID|ID|
|»»» name|string|false|none|班级名称|班级|
|»»» room|string|false|none|班级教室|班级教室|
|»»» beginDate|string(date)|false|none|开课时间|开课时间|
|»»» endDate|string(date)|false|none|结课时间|结课时间|
|»»» masterId|integer(int32)|false|none|班主任id|班主任id, 关联员工表id|
|»»» masterName|string|false|none|班主任姓名|班主任姓名|
|»»» subject|integer(int32)|false|none|学科|1:java, 2:前端, 3:大数据, 4:Python, 5:Go, 6:嵌入式|
|»»» createTime|string(date-time)|false|none|创建时间|创建时间|
|»»» updateTime|string(date-time)|false|none|修改时间|修改时间|

<a id="opIdsaveUsingPOST"></a>

## POST 添加班级

POST /clazzs

添加班级数据

> Body 请求参数

```json
{
  "name": "string",
  "room": "string",
  "beginDate": "2019-08-24",
  "endDate": "2019-08-24",
  "masterId": 0,
  "subject": 0
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» name|body|string| 否 | 班级名称|班级|
|» room|body|string| 否 | 班级教室|班级教室|
|» beginDate|body|string(date)| 否 | 开课时间|开课时间|
|» endDate|body|string(date)| 否 | 结课时间|结课时间|
|» masterId|body|integer(int32)| 否 | 班主任id|班主任id, 关联员工表id|
|» subject|body|integer(int32)| 否 | 学科|1:java, 2:前端, 3:大数据, 4:Python, 5:Go, 6:嵌入式|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdupdateUsingPUT"></a>

## PUT 修改班级

PUT /clazzs

修改班级数据信息

> Body 请求参数

```json
{
  "id": 0,
  "name": "string",
  "room": "string",
  "beginDate": "2019-08-24",
  "endDate": "2019-08-24",
  "masterId": 0,
  "subject": 0,
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z"
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|[Clazz](#schemaclazz)| 否 | Clazz|none|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdfindAllUsingGET"></a>

## GET 查询所有班级

GET /clazzs/list

查询所有班级数据

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdgetInfoUsingGET"></a>

## GET 根据ID查询

GET /clazzs/{id}

根据ID查询班级信息

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|path|integer| 是 ||id|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIddeleteUsingDELETE"></a>

## DELETE 删除班级

DELETE /clazzs/{id}

根据ID删除班级信息

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|path|integer| 是 ||id|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|204|[No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5)|No Content|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

# 部门管理

<a id="opIdlistUsingGET"></a>

## GET 查询所有部门

GET /depts

查询所有部门

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|token|header|string| 否 ||none|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdsaveUsingPOST_1"></a>

## POST 添加部门

POST /depts

添加部门数据

> Body 请求参数

```json
{
  "name": "近派使算他"
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» name|body|string| 否 | 部门名称|none|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdupdateUsingPUT_1"></a>

## PUT 修改部门

PUT /depts

修改部门

> Body 请求参数

```json
{
  "name": "后勤部",
  "id": 10
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» id|body|integer(int32)¦null| 否 | 部门ID|none|
|» name|body|string¦null| 否 | 部门名称|none|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIddeleteUsingDELETE_1"></a>

## DELETE 删除部门

DELETE /depts

根据ID删除部门数据

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|query|integer| 是 ||部门ID|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|204|[No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5)|No Content|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdgetByIdUsingGET"></a>

## GET 根据ID查询

GET /depts/{id}

根据ID查询部门

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|path|integer| 是 ||id|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

# 员工管理

<a id="opIdpageUsingGET_1"></a>

## GET 分页查询

GET /emps

员工信息的分页条件查询

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|page|query|integer| 是 ||页码|
|pageSize|query|integer| 是 ||每页展示记录数|
|name|query|string| 否 ||姓名|
|gender|query|integer| 否 ||性别|
|begin|query|string| 否 ||范围匹配的开始时间(入职日期)|
|end|query|string| 否 ||范围匹配的结束时间(入职日期)|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {
    "total": 0,
    "rows": [
      {
        "id": 0,
        "username": "string",
        "password": "string",
        "name": "string",
        "gender": 0,
        "job": 0,
        "salary": 0,
        "image": "string",
        "entryDate": "2019-08-24",
        "deptId": 0,
        "deptName": "string",
        "createTime": "2019-08-24T14:15:22Z",
        "updateTime": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|
|»» total|integer|true|none|总记录数|总记录数|
|»» rows|[object]|true|none|结果列表|none|
|»»» id|integer(int32)¦null|false|none|ID|ID|
|»»» username|string¦null|false|none|用户名|用户名|
|»»» password|string¦null|false|none|密码|密码|
|»»» name|string¦null|false|none|姓名|姓名|
|»»» gender|integer(int32)¦null|false|none|性别|性别, 1: 男 , 2: 女|
|»»» job|integer(int32)¦null|false|none|职位|职位, 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师|
|»»» salary|integer(int32)|true|none|薪资|薪资|
|»»» image|string¦null|false|none|头像|头像|
|»»» entryDate|string(date)¦null|false|none|入职日期|入职日期|
|»»» deptId|integer(int32)¦null|false|none|部门ID|部门ID|
|»»» deptName|string|false|none|部门名称|部门名称|
|»»» createTime|string(date-time)¦null|false|none|创建时间|创建时间|
|»»» updateTime|string(date-time)¦null|false|none|修改时间|修改时间|

<a id="opIdsaveUsingPOST_2"></a>

## POST 添加员工

POST /emps

添加员工信息

> Body 请求参数

```json
{
  "username": "string",
  "name": "string",
  "gender": 0,
  "job": 0,
  "image": "string",
  "entryDate": "2019-08-24",
  "deptId": 0,
  "salary": 0,
  "exprList": [
    {
      "begin": "2019-08-24",
      "end": "2019-08-24",
      "company": "string",
      "job": "string"
    }
  ]
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» username|body|string¦null| 否 | 用户名|用户名|
|» name|body|string¦null| 否 | 姓名|姓名|
|» gender|body|integer(int32)¦null| 否 | 性别|性别, 1: 男 , 2: 女|
|» job|body|integer(int32)¦null| 否 | 职位|职位, 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师|
|» image|body|string¦null| 否 | 头像|头像|
|» entryDate|body|string(date)¦null| 否 | 入职日期|入职日期|
|» deptId|body|integer(int32)¦null| 否 | 部门ID|部门ID|
|» salary|body|integer(int32)| 否 | 薪资|薪资|
|» exprList|body|[object]| 否 ||none|
|»» begin|body|string(date)| 否 | 开始时间|开始时间|
|»» end|body|string(date)| 否 | 结束时间|结束时间|
|»» company|body|string| 否 | 公司名字|公司名字|
|»» job|body|string| 否 | 职位|职位|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdupdateUsingPUT_2"></a>

## PUT 修改员工

PUT /emps

修改员工信息

> Body 请求参数

```json
{
  "id": 0,
  "username": "string",
  "password": "string",
  "name": "string",
  "gender": 0,
  "job": 0,
  "image": "string",
  "entryDate": "2019-08-24",
  "salary": 0,
  "deptId": 0,
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z",
  "exprList": [
    {
      "id": 1,
      "begin": "2019-08-24",
      "end": "2019-08-24",
      "company": "string",
      "job": "string",
      "empId": 4294967296
    }
  ]
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» id|body|integer(int32)¦null| 否 | ID|ID|
|» username|body|string¦null| 否 | 用户名|用户名|
|» password|body|string¦null| 否 | 密码|密码|
|» name|body|string¦null| 否 | 姓名|姓名|
|» gender|body|integer(int32)¦null| 否 | 性别|性别, 1: 男 , 2: 女|
|» job|body|integer(int32)¦null| 否 | 职位|职位, 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师|
|» image|body|string¦null| 否 | 头像|头像|
|» entryDate|body|string(date)¦null| 否 | 入职日期|入职日期|
|» salary|body|integer(int32)| 否 | 薪资|薪资|
|» deptId|body|integer(int32)¦null| 否 | 部门ID|部门ID|
|» createTime|body|string(date-time)¦null| 否 | 创建时间|创建时间|
|» updateTime|body|string(date-time)¦null| 否 | 修改时间|修改时间|
|» exprList|body|[[EmpExpr](#schemaempexpr)]| 是 | 工作经历列表|工作经历列表|
|»» id|body|integer| 否 | ID, 主键|ID, 主键|
|»» begin|body|string(date)| 否 | 开始时间|开始时间|
|»» end|body|string(date)| 否 | 结束时间|结束时间|
|»» company|body|string| 否 | 公司名字|公司名字|
|»» job|body|string| 否 | 职位|职位|
|»» empId|body|integer| 否 | 员工ID|员工ID|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIddeleteUsingDELETE_2"></a>

## DELETE 批量删除

DELETE /emps

根据ID批量删除员工数据

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|ids|query|string| 否 ||ID值|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|204|[No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5)|No Content|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdlistUsingGET_1"></a>

## GET 查询所有

GET /emps/list

查询所有员工信息

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdgetInfoUsingGET_1"></a>

## GET 根据ID查询

GET /emps/{id}

根据ID查询员工

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|path|integer| 是 ||id|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {
    "id": 0,
    "username": "string",
    "password": "string",
    "name": "string",
    "gender": 0,
    "job": 0,
    "salary": 0,
    "image": "string",
    "entryDate": "2019-08-24",
    "deptId": 0,
    "createTime": "2019-08-24T14:15:22Z",
    "updateTime": "2019-08-24T14:15:22Z",
    "exprList": [
      {
        "id": 1,
        "begin": "2019-08-24",
        "end": "2019-08-24",
        "company": "string",
        "job": "string",
        "empId": 4294967296
      }
    ]
  }
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|
|»» id|integer(int32)¦null|false|none|ID|ID|
|»» username|string¦null|false|none|用户名|用户名|
|»» password|string¦null|false|none|密码|密码|
|»» name|string¦null|false|none|姓名|姓名|
|»» gender|integer(int32)¦null|false|none|性别|性别, 1: 男 , 2: 女|
|»» job|integer(int32)¦null|false|none|职位|职位, 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师|
|»» salary|integer(int32)|true|none|薪资|薪资|
|»» image|string¦null|false|none|头像|头像|
|»» entryDate|string(date)¦null|false|none|入职日期|入职日期|
|»» deptId|integer(int32)¦null|false|none|部门ID|部门ID|
|»» createTime|string(date-time)¦null|false|none|创建时间|创建时间|
|»» updateTime|string(date-time)¦null|false|none|修改时间|修改时间|
|»» exprList|[[EmpExpr](#schemaempexpr)]|false|none|工作经历|工作经历|
|»»» id|integer|false|none|ID, 主键|ID, 主键|
|»»» begin|string(date)|false|none|开始时间|开始时间|
|»»» end|string(date)|false|none|结束时间|结束时间|
|»»» company|string|false|none|公司名字|公司名字|
|»»» job|string|false|none|职位|职位|
|»»» empId|integer|false|none|员工ID|员工ID|

# 通用服务

<a id="opIdloginUsingPOST"></a>

## POST 登录接口

POST /login

该接口用于员工登录Tlias智能学习辅助系统，登录完毕后，系统下发JWT令牌。 
用户登录成功后，系统会自动下发JWT令牌，然后在后续的每次请求中，都需要在请求头header中携带到服务端，请求头的名称为 token ，值为 登录时下发的JWT令牌。 如果检测到用户未登录，则会返回 401 状态码 。

> Body 请求参数

```json
{
  "username": "songjiang",
  "password": "123456"
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» username|body|string| 是 | 用户名|用户名|
|» password|body|string| 是 | 密码|密码|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIduploadUsingPOST"></a>

## POST 文件上传

POST /upload

上传图片接口

> Body 请求参数

```yaml
file: ""

```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» file|body|string(binary)| 否 ||上传的文件|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

# 报表统计

<a id="opIdempGenderDataUsingGET"></a>

## GET 员工性别统计

GET /report/empGenderData

统计员工的性别 

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdempJobDataUsingGET"></a>

## GET 员工职位统计

GET /report/empJobData

统计出每一年入职的员工人数 

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdgetStudentDataUsingGET"></a>

## GET 学生学历统计

GET /report/studentDegreeData

该接口用于统计学生的学历信息

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

## GET 班级人数统计

GET /report/studentCountData

该接口用于统计每个班级的人数信息

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {
    "clazzList": [
      "string"
    ],
    "dataList": [
      0
    ]
  }
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|成功|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|true|none|状态码|1: 成功 , 0: 失败|
|» msg|string|true|none|错误提示信息|none|
|» data|object|true|none|响应的数据|none|
|»» clazzList|[string]|true|none|班级列表|none|
|»» dataList|[integer]|true|none|班级人数列表|none|

## GET 日志列表查询

GET /log/page

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|page|query|number| 否 ||页码|
|pageSize|query|number| 否 ||每页展示记录数|
|token|header|string| 是 ||none|

> 返回示例

> 200 Response

```json
{
  "code": 1,
  "msg": "success",
  "data": {
    "total": 4,
    "rows": [
      {
        "id": 1,
        "operateEmpId": 10,
        "operateTime": "2023-11-08T20:52:07",
        "className": "com.itheima.controller.DeptController",
        "methodName": "update",
        "methodParams": "[Dept(id=7, name=综合服务部2, createTime=2023-10-09T14:34:57, updateTime=2023-10-12T15:44:03)]",
        "returnValue": "{\"code\":1,\"msg\":\"success\"}",
        "costTime": 8,
        "operateEmpName": "林冲"
      },
      {
        "id": 2,
        "operateEmpId": 10,
        "operateTime": "2023-11-08T20:52:13",
        "className": "com.itheima.controller.DeptController",
        "methodName": "update",
        "methodParams": "[Dept(id=7, name=综合服务部, createTime=2023-10-09T14:34:57, updateTime=2023-11-08T20:52:07)]",
        "returnValue": "{\"code\":1,\"msg\":\"success\"}",
        "costTime": 9,
        "operateEmpName": "林冲"
      },
      {
        "id": 3,
        "operateEmpId": 10,
        "operateTime": "2023-11-08T20:52:50",
        "className": "com.itheima.controller.DeptController",
        "methodName": "delete",
        "methodParams": "[7]",
        "returnValue": "{\"code\":1,\"msg\":\"success\"}",
        "costTime": 7,
        "operateEmpName": "林冲"
      },
      {
        "id": 4,
        "operateEmpId": 10,
        "operateTime": "2023-11-08T20:52:56",
        "className": "com.itheima.controller.DeptController",
        "methodName": "add",
        "methodParams": "[Dept(id=null, name=后勤部, createTime=null, updateTime=null)]",
        "returnValue": "{\"code\":1,\"msg\":\"success\"}",
        "costTime": 9,
        "operateEmpName": "林冲"
      }
    ]
  }
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|成功|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|false|none||状态码, 1:成功, 0: 失败|
|» msg|string|false|none||提示信息|
|» data|object|false|none||返回数据|
|»» total|integer|true|none||总记录数|
|»» rows|[object]|true|none||数据列表|
|»»» id|integer|false|none||ID|
|»»» operateEmpId|integer|false|none||操作人ID|
|»»» operateTime|string|false|none||操作时间|
|»»» className|string|false|none||类名|
|»»» methodName|string|false|none||方法名|
|»»» methodParams|string|false|none||方法请求参数|
|»»» returnValue|string|false|none||返回值|
|»»» costTime|integer|false|none||执行耗时|
|»»» operateEmpName|string|false|none||操作人姓名|

# 学生管理

<a id="opIdpageUsingGET_2"></a>

## GET 分页查询

GET /students

学生信息的分页条件查询

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|clazzId|query|integer| 否 ||班级ID|
|degree|query|integer| 否 ||学历|
|name|query|string| 否 ||姓名|
|page|query|integer| 否 ||页码|
|pageSize|query|integer| 否 ||每页记录数|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {
    "total": 0,
    "rows": [
      {
        "id": 0,
        "name": "string",
        "no": "string",
        "gender": 0,
        "phone": "string",
        "idCard": "string",
        "isCollege": 0,
        "address": "string",
        "degree": 0,
        "graduateDate": "2019-08-24T14:15:22Z",
        "clazzId": 0,
        "violationCount": 0,
        "violationScore": 0,
        "createTime": "2019-08-24T14:15:22Z",
        "updateTime": "2019-08-24T14:15:22Z",
        "clazzName": "string"
      }
    ]
  }
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|
|»» total|integer|true|none|总记录数|总记录数|
|»» rows|[object]|true|none|结果列表|结果列表|
|»»» id|integer(int32)|false|none|ID|none|
|»»» name|string|false|none|姓名|none|
|»»» no|string|false|none|学号|none|
|»»» gender|integer(int32)|false|none|性别|1: 男 , 2: 女|
|»»» phone|string|false|none|手机号|none|
|»»» idCard|string|true|none|身份证号|none|
|»»» isCollege|integer(int32)|true|none|是否是院校学生|1: 是 , 0: 否|
|»»» address|string|false|none|联系地址|none|
|»»» degree|integer(int32)|false|none|最高学历|1:初中, 2:高中, 3:大专, 4:本科, 5:硕士, 6:博士|
|»»» graduateDate|string(date-time)|false|none|毕业时间|none|
|»»» clazzId|integer(int32)|false|none|班级ID|none|
|»»» violationCount|integer(int32)|false|none|违纪次数|none|
|»»» violationScore|integer(int32)|false|none|违纪扣分|none|
|»»» createTime|string(date-time)|false|none|创建时间|none|
|»»» updateTime|string(date-time)|false|none|修改时间|none|
|»»» clazzName|string|true|none|班级名称|none|

<a id="opIdsaveUsingPOST_3"></a>

## POST 添加学生

POST /students

添加学员信息

> Body 请求参数

```json
{
  "name": "string",
  "no": "string",
  "gender": 0,
  "phone": "string",
  "idCard": "string",
  "isCollege": "string",
  "address": "string",
  "degree": 0,
  "graduationDate": "2019-08-24T14:15:22Z",
  "clazzId": 0
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» name|body|string| 否 | 姓名|none|
|» no|body|string| 否 | 学号|none|
|» gender|body|integer(int32)| 否 | 性别|1: 男 , 2: 女|
|» phone|body|string| 否 | 手机号|none|
|» idCard|body|string| 是 | 身份证号|none|
|» isCollege|body|string| 是 | 是否是院校学生|1: 是 , 0: 否|
|» address|body|string| 否 | 联系地址|none|
|» degree|body|integer(int32)| 否 | 最高学历|1:初中, 2:高中, 3:大专, 4:本科, 5:硕士, 6:博士|
|» graduationDate|body|string(date-time)| 否 | 毕业时间|none|
|» clazzId|body|integer(int32)| 否 | 班级ID|none|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdupdateUsingPUT_3"></a>

## PUT 修改学生

PUT /students

修改学生信息

> Body 请求参数

```json
{
  "id": 0,
  "name": "string",
  "no": "string",
  "gender": 0,
  "phone": "string",
  "idCard": "string",
  "isCollege": 0,
  "address": "string",
  "degree": 0,
  "graduationDate": "2019-08-24T14:15:22Z",
  "clazzId": 0,
  "violationCount": 0,
  "violationScore": 0,
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z"
}
```

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|[Student](#schemastudent)| 否 | Student|none|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdviolationHandleUsingPUT"></a>

## PUT 违纪处理

PUT /students/violation/{id}/{score}

学生违纪信息处理

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|path|integer| 是 ||id|
|score|path|integer| 是 ||score|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|201|[Created](https://tools.ietf.org/html/rfc7231#section-6.3.2)|Created|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIddeleteUsingDELETE_3"></a>

## DELETE 批量删除学生

DELETE /students/{ids}

批量删除学生信息

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|ids|path|string| 是 ||ids|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[Result](#schemaresult)|
|204|[No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5)|No Content|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|

### 返回数据结构

状态码 **200**

*Result*

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

<a id="opIdgetInfoUsingGET_2"></a>

## GET 根据ID查询

GET /students/{id}

根据ID查询

### 请求参数

|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|id|path|integer| 是 ||id|

> 返回示例

> 200 Response

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}
```

### 返回结果

|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|Inline|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized|Inline|
|403|[Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3)|Forbidden|Inline|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|Inline|

### 返回数据结构

状态码 **200**

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|» msg|string¦null|false|none|错误提示信息|none|
|» data|object¦null|false|none|响应数据|none|

# 数据模型

<h2 id="tocS_LoginInfo">LoginInfo</h2>

<a id="schemalogininfo"></a>
<a id="schema_LoginInfo"></a>
<a id="tocSlogininfo"></a>
<a id="tocslogininfo"></a>

```json
{
  "id": 0,
  "username": "string",
  "name": "string",
  "token": "string"
}

```

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|id|number|true|none|员工ID|none|
|username|string|true|none|用户名|none|
|name|string|true|none|姓名|none|
|token|string|true|none|令牌|none|

<h2 id="tocS_EmpExpr">EmpExpr</h2>

<a id="schemaempexpr"></a>
<a id="schema_EmpExpr"></a>
<a id="tocSempexpr"></a>
<a id="tocsempexpr"></a>

```json
{
  "id": 1,
  "begin": "2019-08-24",
  "end": "2019-08-24",
  "company": "string",
  "job": "string",
  "empId": 4294967296
}

```

员工工作经历表

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|id|integer|false|none|ID, 主键|ID, 主键|
|begin|string(date)|false|none|开始时间|开始时间|
|end|string(date)|false|none|结束时间|结束时间|
|company|string|false|none|公司名字|公司名字|
|job|string|false|none|职位|职位|
|empId|integer|false|none|员工ID|员工ID|

<h2 id="tocS_PageBean">PageBean</h2>

<a id="schemapagebean"></a>
<a id="schema_PageBean"></a>
<a id="tocSpagebean"></a>
<a id="tocspagebean"></a>

```json
{
  "total": 0,
  "rows": [
    "string"
  ]
}

```

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|total|integer|true|none|总记录数|总记录数|
|rows|[string]|true|none|结果列表|结果列表|

<h2 id="tocS_Student">Student</h2>

<a id="schemastudent"></a>
<a id="schema_Student"></a>
<a id="tocSstudent"></a>
<a id="tocsstudent"></a>

```json
{
  "id": 0,
  "name": "string",
  "no": "string",
  "gender": 0,
  "phone": "string",
  "idCard": "string",
  "isCollege": 0,
  "address": "string",
  "degree": 0,
  "graduationDate": "2019-08-24T14:15:22Z",
  "clazzId": 0,
  "violationCount": 0,
  "violationScore": 0,
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z"
}

```

Student

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|id|integer(int32)|false|none|ID|none|
|name|string|false|none|姓名|none|
|no|string|false|none|学号|none|
|gender|integer(int32)|false|none|性别|1: 男 , 2: 女|
|phone|string|false|none|手机号|none|
|idCard|string|false|none|身份证号|none|
|isCollege|integer(int32)|false|none|是否是院校学生|1: 是 , 0: 否|
|address|string|false|none|联系地址|none|
|degree|integer(int32)|false|none|最高学历|1:初中, 2:高中, 3:大专, 4:本科, 5:硕士, 6:博士|
|graduationDate|string(date-time)|false|none|毕业时间|none|
|clazzId|integer(int32)|false|none|班级ID|none|
|violationCount|integer(int32)|false|none|违纪次数|none|
|violationScore|integer(int32)|false|none|违纪扣分|none|
|createTime|string(date-time)|false|none|创建时间|none|
|updateTime|string(date-time)|false|none|修改时间|none|

<h2 id="tocS_Clazz">Clazz</h2>

<a id="schemaclazz"></a>
<a id="schema_Clazz"></a>
<a id="tocSclazz"></a>
<a id="tocsclazz"></a>

```json
{
  "id": 0,
  "name": "string",
  "room": "string",
  "beginDate": "2019-08-24",
  "endDate": "2019-08-24",
  "masterId": 0,
  "subject": 0,
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z"
}

```

Clazz

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|id|integer(int32)|false|none|ID|ID|
|name|string|false|none|班级名称|班级|
|room|string|false|none|班级教室|班级教室|
|beginDate|string(date)|false|none|开课时间|开课时间|
|endDate|string(date)|false|none|结课时间|结课时间|
|masterId|integer(int32)|false|none|班主任id|班主任id, 关联员工表id|
|subject|integer(int32)|false|none|学科|1:java, 2:前端, 3:大数据, 4:Python, 5:Go, 6:嵌入式|
|createTime|string(date-time)|false|none|创建时间|创建时间|
|updateTime|string(date-time)|false|none|修改时间|修改时间|

<h2 id="tocS_Emp">Emp</h2>

<a id="schemaemp"></a>
<a id="schema_Emp"></a>
<a id="tocSemp"></a>
<a id="tocsemp"></a>

```json
{
  "id": 0,
  "username": "string",
  "password": "string",
  "name": "string",
  "gender": 0,
  "job": 0,
  "salary": 0,
  "image": "string",
  "entryDate": "2019-08-24",
  "deptId": 0,
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z"
}

```

Emp

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|id|integer(int32)¦null|false|none|ID|ID|
|username|string¦null|false|none|用户名|用户名|
|password|string¦null|false|none|密码|密码|
|name|string¦null|false|none|姓名|姓名|
|gender|integer(int32)¦null|false|none|性别|性别, 1: 男 , 2: 女|
|job|integer(int32)¦null|false|none|职位|职位, 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师|
|salary|integer(int32)|true|none|薪资|薪资|
|image|string¦null|false|none|头像|头像|
|entryDate|string(date)¦null|false|none|入职日期|入职日期|
|deptId|integer(int32)¦null|false|none|部门ID|部门ID|
|createTime|string(date-time)¦null|false|none|创建时间|创建时间|
|updateTime|string(date-time)¦null|false|none|修改时间|修改时间|

<h2 id="tocS_Dept">Dept</h2>

<a id="schemadept"></a>
<a id="schema_Dept"></a>
<a id="tocSdept"></a>
<a id="tocsdept"></a>

```json
{
  "id": 0,
  "name": "string",
  "createTime": "2019-08-24T14:15:22Z",
  "updateTime": "2019-08-24T14:15:22Z"
}

```

Dept

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|id|integer(int32)¦null|false|none|部门ID|none|
|name|string¦null|false|none|部门名称|none|
|createTime|string(date-time)¦null|false|none|创建时间|none|
|updateTime|string(date-time)¦null|false|none|修改时间|none|

<h2 id="tocS_Result">Result</h2>

<a id="schemaresult"></a>
<a id="schema_Result"></a>
<a id="tocSresult"></a>
<a id="tocsresult"></a>

```json
{
  "code": 0,
  "msg": "string",
  "data": {}
}

```

Result

### 属性

|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|code|integer(int32)|false|none|状态码|1: 成功 , 0: 失败|
|msg|string¦null|false|none|错误提示信息|none|
|data|object¦null|false|none|响应数据|none|