查询巡检覆盖率(API名称:queryInspectCoverageRate)
功能介绍
查询巡检覆盖率。
相关接口
接口名称 | 调用说明 |
|---|---|
调用该接口获取到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中获取的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"
} 
