查询巡检覆盖率（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"
}
