# 查询kcp扣分占比（API名称：queryKcpDeductPointRatio）
#### 功能介绍
查询kcp扣分占比。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                             | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/hwRetailTask/ queryKcpDeductPointRatio | 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的值 |
   
#### 请求参数
| **参数**       | **类型** | **是否必填**                                                                 | **描述**                                                                        |
|:---|:---|:---|:---|
| pageStart    | int    | 可选                                                                       | 当前页码：从0开始                                                                     |
| pageSize     | int    | 可选                                                                       | 每页数量：默认15条， 最多100条 |
| imageLevel   | String | 必选                                                                       | 全球形象等级                                                                        |
| region       | String | 可选，单选 不选时默认全国 | 代表处                                                                           |
| taskScene    | String | 必选                                                                       | 任务场景                                                                          |
| sceneVersion | String | 可选                                                                       | 任务场景版本                                                                        |
| position     | String | 可选                                                                       | 岗位                                                                            |
| startDate    | date   | 必选                                                                       | 开始时间                                                                          |
| endDate      | date   | 必选                                                                       | 结束时间                                                                          |
   
#### 响应参数
| **字段名**      | **数据类型** | **字段名称**         |
|:---|:---|:---|
| stateCode    | String   | 响应状态码：0-成功；其他-失败 |
| errorMessage | String   | 响应描述             |
| result       | Object   | 响应结果内容data、分页数据  |
   
result出参:
| **字段名**     | **数据类型**       | **字段名称**   |
|:---|:---|:---|
| pos         | int            | 当前页：从0开始   |
| total_count | int            | 总数量        |
| data        | List\<Object\> | 响应结果内容data |
   
data的参数：
| **字段名**          | **数据类型**       | **字段名称**  |
|:---|:---|:---|
| itemOverallRate  | String         | item整体合格率 |
| kcpOverallDeduct | int            | kcp整体扣分   |
| kcpDetail        | List\<Object\> | kcp明细     |
   
kcpDetail的参数:
| **字段名**            | **数据类型**       | **字段名称**  |
|:---|:---|:---|
| kcpName            | String         | kcp名称     |
| kcpQualifiedRate   | String         | kcp合格率    |
| deductPoints       | int            | 扣分        |
| kcpDeductRate      | String         | kcp扣分占比   |
| itemQualifiedNum   | int            | item合格个数  |
| itemUnqualifiedNum | int            | item不合格个数 |
| itemDetail         | List\<Object\> | item明细    |
   
itemDetail的参数：
| **字段名**       | **数据类型** | **字段名称** |
|:---|:---|:---|
| itemName      | String   | item名称   |
| qualifiedNum  | int      | 合格数      |
| qualifiedRate | String   | 合格率      |
   
#### 请求示例
```
{
    "pageStart": 0,
    "pageSize": 3,
    "imageLevel": "智能生活馆",
    "taskScene": "【现场巡检2.0】-智能生活馆",
    "region": [
        "江苏-生活馆"
    ],
    "startDate": "2000-04-30",
    "endDate": "2030-04-30"
}
```
#### 响应示例
```
{
    "stateCode": "0",
    "errorMessage": "成功",
    "result": {
        "pos": 0,
        "totalCount": 16,
        "data": [
            {
                "kcpOverallDeduct": null,
                "itemOverallRate": "98%",
                "kcpDetail": [
                    {
                        "itemQualifiedNum": 42,
                        "kcpDeductRate": null,
                        "kcpQualifiedRate": "100%",
                        "deductPoints": null,
                        "kcpName": "EHS相关",
                        "itemUnqualifiedNum": 42,
                        "itemDetail": [
                            {
                                "itemName": "口罩酒精",
                                "qualifiedNum": 51,
                                "qualifiedRate": "94.44%"
                            },
                            {
                                "itemName": "急救箱",
                                "qualifiedNum": 51,
                                "qualifiedRate": "100.00%"
                            },
                            {
                                "itemName": "消防安全",
                                "qualifiedNum": 54,
                                "qualifiedRate": "100.00%"
                            },
                            {
                                "itemName": "消防安全通道",
                                "qualifiedNum": 53,
                                "qualifiedRate": "100.00%"
                            },
                            {
                                "itemName": "灭火器",
                                "qualifiedNum": 55,
                                "qualifiedRate": "100.00%"
                            },
                            {
                                "itemName": "灭火器副本",
                                "qualifiedNum": 1,
                                "qualifiedRate": "100.00%"
                            },
                            {
                                "itemName": "用电安全",
                                "qualifiedNum": 53,
                                "qualifiedRate": "100.00%"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
```