# 删除检查单（API名称：deleteTask）
#### 功能介绍
用户自己创建的检查单，不需要使用或者其他原因废弃的，可以通过该接口进行删除。
![](https://support.huaweicloud.com/api-isdp/public_sys-resources/note_3.0-zh-cn.png)
只有检查单的创建人可以删除检查单。
#### 相关接口
| **接口名称**                                                                              | **调用说明**                                                                                                  |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html)                  | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                              |
| [查询EHS检查单（API名称：findTask）](https://support.huaweicloud.com/api-isdp/api_01_0221.html) | 调用该接口获取到待删除检查单的客户检查单id。 删除任务时，需要输入获取到的客户检查单id。 |
   
#### 调用流程
图1删除检查单流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522734587.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                          | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/openTask/deleteTask | 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的值 |
   
#### 请求参数
| **参数**         | **类型**         | **是否必填** | **描述**                                                                                                                                                                    |
|:---|:---|:---|:---|
| customerTaskId | List\<String\> | 是        | 客户检查单id集合 获取客户检查单id API，请参见[查询EHS检查单（API名称：findTask）](https://support.huaweicloud.com/api-isdp/api_01_0221.html) |
   
#### 响应参数
| **参数**         | **类型**         | **描述**                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| stateCode      | String         | 响应状态码： - 0-成功  - 其他-失败   |
| errorMessage   | String         | 响应描述                                                                                                                                                                                                                                                                                                                                                                                              |
| result         | List\<Object\> | 响应结果内容List，数量对应入参的数量                                                                                                                                                                                                                                                                                                                                                                              |
| customerTaskId | String         | 客户检查单ID                                                                                                                                                                                                                                                                                                                                                                                           |
| status         | int            | 返回状态： - 0-成功  - 1-失败            |
| message        | String         | 返回的失败消息                                                                                                                                                                                                                                                                                                                                                                                           |
   
#### 请求示例
```
{
    "customerTaskId": [
        123456789123456789,
        1234567894,
        1234567895,
        123456888,
        1234567896
    ]
}
```
#### 响应示例
```
{
    "stateCode": "0",
    "errorMessage": null,
    "result": [
        {
            "status": "1",
            "message": "检查单不存在！",
            "customerTaskId": 123456789123456789,
            "taskId": null
        },
        {
            "status": "1",
            "message": "不是该检查单的创建人，不能删除！",
            "customerTaskId": 123456888,
            "taskId": null
        },
        {
            "status": "0",
            "message": "删除成功！",
            "customerTaskId": 1234567894,
            "taskId": null
        },
        {
            "status": "0",
            "message": "删除成功！",
            "customerTaskId": 1234567895,
            "taskId": null
        },
        {
            "status": "0",
            "message": "删除成功！",
            "customerTaskId": 1234567896,
            "taskId": null
        }
    ]
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。