
# 查询得分/合格率趋势（API名称：queryScoreRateTrend）
#### 功能介绍
查询得分/合格率趋势。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                       | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/hwRetailTask/queryScoreRateTrend | 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的参数：
| **字段名**     | **数据类型**       | **字段名称** |
|:---|:---|:---|
| records     | List\<Object\> | 得分、合格率记录 |
| tableHeader | List\<Object\> | 表头定义     |
   
records的参数:
| **字段名**  | **数据类型**   | **字段名称**                    |
|:---|:---|:---|
| name     | String     | 名称（取值范围：全国，省份，差异性）          |
| rate     | String     | 合格率/全国和省份合格率差异              |
| score    | String     | 得分/全国和省份得分差异                |
| kcp1     | Map        | kcp1下item合格率/全国和省份item合格率差异 |
| Kcp2     | Map        | Kcp2下item合格率/全国和省份item合格率差异 |
| ........ | .......... | ..........                  |
| kcpn     | Map        | Kcpn下item合格率/全国和省份item合格率差异 |
   
kcpn的参数:
| **字段名**   | **数据类型** | **字段名称**                |
|:---|:---|:---|
| item1     | String   | Item1合格率/全国和省份item合格率差异 |
| Item2     | String   | Item2合格率/全国和省份item合格率差异 |
| ......... | String   | .............           |
| itemn     | String   | Itemn合格率/全国和省份item合格率差异 |
   
tableHeader的参数：
| **字段名**      | **数据类型**    | **字段名称**     |
|:---|:---|:---|
| kcpName      | String      | kcp名称        |
| attribute    | String      | 表头kcp对应取值标识  |
| itemNameList | List\<Map\> | kcp下item名称列表 |
   
itemNameList的参数：
| **字段名**   | **数据类型** | **字段名称**     |
|:---|:---|:---|
| name      | String   | item名称       |
| attribute | String   | 表头item对应取值标识 |
   
#### 请求示例
```
{
    "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": 0,
        "data": [
            {
                "detail": {
                    "records": [],
                    "tableHeader": []
                }
            }
        ],
        "header": null
    }
}
```
