# 查询巡检覆盖率（API名称：queryInspectCoverageRate）
#### 功能介绍
查询巡检覆盖率。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                                     | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/hwRetailCoverageIssue/queryInspectCoverageRate | 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的值 |
   
#### 请求参数
| **参数**       | **类型** | **是否必填** | **描述**            |
|:---|:---|:---|:---|
| imageLevel   | String | 必选       | 全球形象等级            |
| region       | String | 可选       | 代表处               |
| taskScene    | String | 必选       | 任务场景              |
| sceneVersion | String | 可选       | 任务场景版本            |
| position     | String | 可选       | 岗位                |
| startDate    | date   | 必选       | 开始时间              |
| endDate      | date   | 必选       | 结束时间              |
| pageStart    | int    | 可选       | 当前页码：,从0开始        |
| pageSize     | int    | 可选       | 每页数量：默认15条，最多100条 |
   
#### 响应参数
| **字段名**      | **数据类型** | **字段名称**           |
|:---|:---|:---|
| stateCode    | String   | 接口响应码。0代表成功，非0代表失败 |
| errorMessage | String   | 接口请求错误原因           |
| result       | Object   | 需要返回给调用者的数据        |
   
result出参:
| **字段名**     | **数据类型**       | **字段名称**   |
|:---|:---|:---|
| pos         | int            | 当前页：从0开始   |
| total_count | int            | 总数量        |
| data        | List\<Object\> | 响应结果内容data |
   
data的参数：
| **字段名**             | **数据类型**       | **字段名称** |
|:---|:---|:---|
| overallCoverageRate | String         | 整体覆盖率    |
| totalStoreNum       | int            | 所有门店数    |
| coverageStoreNum    | int            | 已巡检门店数   |
| detail              | List\<Object\> | 明细       |
   
detail的参数：
| **字段名**              | **数据类型** | **字段名称** |
|:---|:---|:---|
| provice              | String   | 省份       |
| totalStoreNum        | int      | 所有门店数    |
| inspectedStoreNumber | int      | 已巡检门店数   |
| coverageRate         | String   | 省份巡检覆盖率  |
| coverageTimes        | int      | 省份巡检次数   |
   
#### 请求示例
```
{
    "taskScene": "【现场巡检】-（智能生活馆）",
    "startDate": "2022-04-18",
    "endDate": "2022-05-18",
    "imageLevel": "智能生活馆",
    "pageSize": 100,
    "pageStart": 0,
    "orderBy": 0
}
```
#### 响应示例
```
{
    "errorMessage": "成功",
    "result": {
        "data": [
            {
                "coverageStoreNum": 15,
                "detail": [
                    {
                        "coverageRate": "100%",
                        "coverageTimes": 4,
                        "inspectedStoreNumber": 3,
                        "province": "贵州",
                        "totalStoreNum": 3
                    },
                    {
                        "coverageRate": "66%",
                        "coverageTimes": 5,
                        "inspectedStoreNumber": 2,
                        "province": "云南",
                        "totalStoreNum": 3
                    },
                    {
                        "coverageRate": "60%",
                        "coverageTimes": 6,
                        "inspectedStoreNumber": 3,
                        "province": "山西",
                        "totalStoreNum": 5
                    },
                    {
                        "coverageRate": "33%",
                        "coverageTimes": 1,
                        "inspectedStoreNumber": 1,
                        "province": "安徽",
                        "totalStoreNum": 3
                    },
                    {
                        "coverageRate": "33%",
                        "coverageTimes": 1,
                        "inspectedStoreNumber": 1,
                        "province": "陕西",
                        "totalStoreNum": 3
                    },
                    {
                        "coverageRate": "16%",
                        "coverageTimes": 1,
                        "inspectedStoreNumber": 1,
                        "province": "四川",
                        "totalStoreNum": 6
                    },
                    {
                        "coverageRate": "16%",
                        "coverageTimes": 2,
                        "inspectedStoreNumber": 1,
                        "province": "河北",
                        "totalStoreNum": 6
                    },
                    {
                        "coverageRate": "11%",
                        "coverageTimes": 1,
                        "inspectedStoreNumber": 1,
                        "province": "北京",
                        "totalStoreNum": 9
                    },
                    {
                        "coverageRate": "8%",
                        "coverageTimes": 1,
                        "inspectedStoreNumber": 1,
                        "province": "广东",
                        "totalStoreNum": 12
                    },
                    {
                        "coverageRate": "6%",
                        "coverageTimes": 1,
                        "inspectedStoreNumber": 1,
                        "province": "山东",
                        "totalStoreNum": 15
                    }
                ],
                "overallCoverageRate": "9%",
                "totalStoreNum": 161
            }
        ],
        "pos": 0,
        "totalCount": 1
    },
    "stateCode": "0"
}
```