
h2. Paths {anchor:paths}

h3. 创建用户 {anchor:postuserusingpost}
{noformat}
POST /users/
{noformat}


h4. Description
根据User对象创建用户


h4. Parameters

||Type||Name||Description||Schema||
|*Body*|*user*\\ \\ _required_||user||[User|#user]|


h4. Responses

||HTTP Code||Description||Schema||
|*200*||OK||string|
|*201*||Created||No Content|
|*401*||Unauthorized||No Content|
|*403*||Forbidden||No Content|
|*404*||Not Found||No Content|


h4. Consumes

* {noformat}application/json{noformat}


h4. Produces

* {noformat}\*/*{noformat}


h4. Tags

* 用户管理


h4. Security

||Type||Name||Scopes||
|*apiKey*|*[Authorization|#authorization]*||global|


h3. 获取用户列表 {anchor:getuserlistusingget}
{noformat}
GET /users/
{noformat}


h4. Responses

||HTTP Code||Description||Schema||
|*200*||OK||< [User|#user] > array|
|*401*||Unauthorized||No Content|
|*403*||Forbidden||No Content|
|*404*||Not Found||No Content|


h4. Produces

* {noformat}\*/*{noformat}


h4. Tags

* 用户管理


h4. Security

||Type||Name||Scopes||
|*apiKey*|*[Authorization|#authorization]*||global|


h3. 获取用户详细信息 {anchor:getuserusingget}
{noformat}
GET /users/{id}
{noformat}


h4. Description
根据url的id来获取用户详细信息


h4. Parameters

||Type||Name||Description||Schema||
|*Path*|*id*\\ \\ _required_||id||integer (int64)|


h4. Responses

||HTTP Code||Description||Schema||
|*200*||OK||[User|#user]|
|*401*||Unauthorized||No Content|
|*403*||Forbidden||No Content|
|*404*||Not Found||No Content|


h4. Produces

* {noformat}\*/*{noformat}


h4. Tags

* 用户管理


h4. Security

||Type||Name||Scopes||
|*apiKey*|*[Authorization|#authorization]*||global|


h3. 更新用户详细信息 {anchor:putuserusingput}
{noformat}
PUT /users/{id}
{noformat}


h4. Description
根据url的id来指定更新对象，并根据传过来的user信息来更新用户详细信息


h4. Parameters

||Type||Name||Description||Schema||
|*Path*|*id*\\ \\ _required_||用户编号||integer (int64)|
|*Body*|*user*\\ \\ _required_||user||[User|#user]|


h4. Responses

||HTTP Code||Description||Schema||
|*200*||OK||string|
|*201*||Created||No Content|
|*401*||Unauthorized||No Content|
|*403*||Forbidden||No Content|
|*404*||Not Found||No Content|


h4. Consumes

* {noformat}application/json{noformat}


h4. Produces

* {noformat}\*/*{noformat}


h4. Tags

* 用户管理


h4. Security

||Type||Name||Scopes||
|*apiKey*|*[Authorization|#authorization]*||global|


h3. 删除用户 {anchor:deleteuserusingdelete}
{noformat}
DELETE /users/{id}
{noformat}


h4. Description
根据url的id来指定删除对象


h4. Parameters

||Type||Name||Description||Schema||
|*Path*|*id*\\ \\ _required_||id||integer (int64)|


h4. Responses

||HTTP Code||Description||Schema||
|*200*||OK||string|
|*204*||No Content||No Content|
|*401*||Unauthorized||No Content|
|*403*||Forbidden||No Content|


h4. Produces

* {noformat}\*/*{noformat}


h4. Tags

* 用户管理


h4. Security

||Type||Name||Scopes||
|*apiKey*|*[Authorization|#authorization]*||global|



