# 注销人员账号（API名称：deregisterPerson）
#### 功能介绍
人员不需要使用账号时，可以通过该接口用于注销人员账号。
#### 相关API
| 接口名称                                                                   | 调用说明                                                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html)   | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                             |
| [查询租户下用户信息](https://support.huaweicloud.com/api-isdp/api_01_0109.html) | 调用该接口获取人员账号。 注销人员账号时，需要输入人员账号。 |
   
#### 调用流程
图1注销人员账号流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002490814804.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                              | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/person/deregisterPerson | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**     | **类型** | **是否必填** | **描述**                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| personCode | String | 是        | 人员账号，如："159\*\*\*\*\*\*\*\*\*" 获取人员账号API请参见：[查询租户下用户信息（API名称：getPersonListByTenant）](https://support.huaweicloud.com/api-isdp/api_01_0109.html) |
   
#### 响应参数
| **参数** | **类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| status | String | 响应状态码： - success-成功  - failed-失败   |
| msg    | String | 响应描述：注销人员成功                                                                                                                                                                                                                                                                                                                                                                                          |
| data   | Object | 响应结果：Null                                                                                                                                                                                                                                                                                                                                                                                            |
   
#### 请求示例
```
{
    "personCode":"159*********"
}
```
#### 响应示例
```
{
    "status": "success",
    "msg": "注销人员成功",
    "data":null
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。