# test-controller-1



本模块共 5 个接口。源文件：`api.json`。



## 快速索引



| 接口名称 | 方法 | 路径 | 用途 |
| --- | --- | --- | --- |
| 获取用户列表 | GET | `/gd_dataserver/test/user/list` | - |
| 新增用户 | POST | `/gd_dataserver/test/user/save` | - |
| 更新用户 | PUT | `/gd_dataserver/test/user/update` | - |
| 获取用户详细 | GET | `/gd_dataserver/test/user/{userId}` | - |
| 删除用户信息 | DELETE | `/gd_dataserver/test/user/{userId}` | - |


## 接口详情



### 获取用户列表

- **用途：** 接口文档未提供用途说明。
- **请求：** `GET /gd_dataserver/test/user/list`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `userListUsingGET_1`

参数：

_无_

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: R«List«UserEntity»» |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 新增用户

- **用途：** 接口文档未提供用途说明。
- **请求：** `POST /gd_dataserver/test/user/save`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `saveUsingPOST_2`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| mobile | query | 否 | string | 用户手机 | - |
| password | query | 否 | string | 用户密码 | - |
| userId | query | 否 | integer / int32 | 用户id | - |
| username | query | 否 | string | 用户名称 | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: R«string» |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 更新用户

- **用途：** 接口文档未提供用途说明。
- **请求：** `PUT /gd_dataserver/test/user/update`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `updateUsingPUT`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`UserEntity`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| mobile | 否 | string | 用户手机 | - |
| password | 否 | string | 用户密码 | - |
| userId | 否 | integer / int32 | 用户ID | - |
| username | 否 | string | 用户名称 | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: R«string» |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 获取用户详细

- **用途：** 接口文档未提供用途说明。
- **请求：** `GET /gd_dataserver/test/user/{userId}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getUserUsingGET`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| userId | path | 是 | integer / int32 | 用户ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: R«UserEntity» |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 删除用户信息

- **用途：** 接口文档未提供用途说明。
- **请求：** `DELETE /gd_dataserver/test/user/{userId}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `deleteUsingDELETE_2`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| userId | path | 是 | integer / int32 | 用户ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: R«string» |
| 204 | No Content | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |