# 查询巡检得分（API名称：queryHWRetailTaskScore）
#### 功能介绍
查询巡检得分。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                          | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/hwRetailTask/queryHWRetailTaskScore | 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   | 必选                                                                      | 结束时间              |
| orderBy      | int    | 必选                                                                      | 排序字段 0:得分 1:合格率   |
   
#### 响应参数
| **字段名**      | **数据类型** | **字段名称**           |
|:---|:---|:---|
| stateCode    | String   | 接口响应码。0代表成功，非0代表失败 |
| errorMessage | String   | 接口请求错误原因           |
| result       | Object   | 需要返回给调用者的数据        |
   
result出参:
| **字段名**     | **数据类型**       | **字段名称**   |
|:---|:---|:---|
| pos         | int            | 当前页：从0开始   |
| total_count | int            | 总数量        |
| data        | List\<Object\> | 响应结果内容data |
   
data的参数：
| **字段名**      | **数据类型**       | **字段名称** |
|:---|:---|:---|
| averageScore | int            | 平均得分     |
| averageRate  | String         | 平均合格率    |
| totalRate    | String         | 总合格率     |
| detail       | List\<Object\> | 明细       |
   
detail的参数：
| **字段名**       | **数据类型** | **字段名称**        |
|:---|:---|:---|
| regionFlag    | int      | 区域标识，0：代表处；1：门店 |
| region        | String   | 区域              |
| score         | int      | 得分              |
| qualifiedRate | String   | 合格率             |
   
#### 请求示例
```
{
    "pageStart": 0,
    "pageSize": 100,
    "imageLevel": "智能生活馆",
    "taskScene": "【现场巡检2.0】-智能生活馆",
    "region": [
        "江苏-生活馆"
    ],
    "sceneVersion": "1.0",
    "startDate": "2022-04-14",
    "endDate": "2023-05-14",
    "orderBy": 0
}
```
#### 响应示例
```
{
    "stateCode": "0",
    "errorMessage": "成功",
    "result": {
        "pos": 0,
        "totalCount": 289,
        "data": [
            {
                "averageRate": "98%",
                "averageScore": null,
                "totalRate": "98%",
                "detail": [
                    {
                        "score": null,
                        "qualifiedRate": "93%",
                        "region": "山西-生活馆",
                        "regionFlag": 0
                    },
                    {
                        "score": null,
                        "qualifiedRate": "95%",
                        "region": "山西-生活馆",
                        "regionFlag": 0
                    }
                ]
            }
        ]
    }
}
```