5.APP数据看板相关API

API列表

编号 API名称
5.1 APP首页数据看板总览
5.2 获取二级页面活跃度和覆盖率
5.3 根据项目和网格区域查询覆盖的房屋/未覆盖的房屋
5.4 收缴率二级页面获取本月收缴率
5.5 获取当前管家评价汇总统计
5.6 评价二级页面
5.7 数据面板获取网格区域
5.8 首页数据看板各种数量

HTTP协议：

HTTP,HTTPS

API调用

5.1:APP首页数据看板总览

APP首页数据看板总览

请求信息

URI：https://smart-assistant-uat.smartmideazy.com/biz/daily/statis/data/kan-ban

方法：POST

请求参数

名称 位置 类型 必填 描述
appId BODY STRING 否 APPID
userId BODY Long 是 用户ID
areaCode BODY STRING 是 区域网格编码
areaId BODY Integer 否 区域ID
communityId BODY Integer 否 项目ID

请求Body描述(非Form表单数据)

{
    "appId":"1000",
    "userId":"12546",
    "areaCode":"FS-HC-WG04",
    "areaId":"1212007",
    "communityId":1003837
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
womTimeRate data BigDecimal 是 及时率(%)
womCollectionRate data BigDecimal 是 收缴率(%)
evalCount data BigDecimal 是 评价数
likeCount data BigDecimal 是 点赞数
activityUserRate data BigDecimal 是 活跃度(%)
overrideHouseRate data BigDecimal 是 覆盖率(%)
workOrderNum data BigDecimal 是 工单数
dissWorkOrderNum data BigDecimal 是 不满意工单数

返回结果示例

{
    "code": 200,
    "data": {
        "womTimeRate": 0,
        "womCollectionRate": 0,
        "evalCount": 0,
        "activityUserRate": 0,
        "likeCount": 0,
        "overrideHouseRate": 11.57,
        "workOrderNum": 0,
        "dissWorkOrderNum": 0
    },
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

5.2:获取二级页面活跃度和覆盖率

获取二级页面活跃度和覆盖率

请求信息

URI：https://smart-assistant-uat.smartmideazy.com/biz/daily/statis/data/activity-override

方法：POST

请求参数

名称 位置 类型 必填 描述
areaId BODY Integer 是 区域ID
communityId BODY Integer 是 项目ID

请求Body描述(非Form表单数据)

{
    "areaId":"1212007",
    "communityId":1003837
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
activityUserCount data Bigdecimal 否 活动人数
totalUserCount data Bigdecimal 否 总人数
activityUserRate data Bigdecimal 否 活跃度(%)
totalHouseCount data Bigdecimal 否 总房屋数
overrideHouseCount data Bigdecimal 否 覆盖的房屋数
overrideHouseRate data Bigdecimal 否 房屋覆盖率(%)

返回结果示例

{
    "code": 200,
    "data": {
        "activityUserCount": 0,
        "totalUserCount": 91,
        "activityUserRate": 0,
        "totalHouseCount": 605,
        "overrideHouseCount": 70,
        "overrideHouseRate": 11.57
    },
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

5.3:根据项目和网格区域查询覆盖的房屋/未覆盖的房屋

根据项目和网格区域查询覆盖的房屋/未覆盖的房屋

请求信息

URI：https://smart-assistant-uat.smartmideazy.com/biz/daily/statis/data/over-or-unover/house

方法：POST

请求参数

名称 位置 类型 必填 描述
areaId BODY Integer 是 区域ID
communityId BODY Integer 是 项目ID
status BODY STRING 是 查询的房屋状态：status：4：覆盖的 0：未覆盖的
pageNo BODY Integer 是 页码
pageSize BODY Integer 是 分页数

请求Body描述(非Form表单数据)

{
    "areaId":"1212007",
    "communityId":1003837,
    "status":"0"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象

返回结果示例

{
    "code": 200,
    "data": {
        "total": 1120,
        "pages": 112,
        "pageNo": 1,
        "recods": [
            {
                "houseName": "6栋_1单元_603",
                "houseId": 537048,
                "unitId": 68110,
                "communityName": "美的翰诚嘉园",
                "buildId": 68106,
                "communityId": 1003837,
                "userName": "卢先生",
                "userId": 25,
                "status": 3
            },
            {
                "houseName": "3栋_1单元_403",
                "houseId": 535241,
                "unitId": 68107,
                "communityName": "美的翰诚嘉园",
                "buildId": 68103,
                "communityId": 1003837,
                "userName": "黄宇培",
                "userId": 27,
                "status": 3
            },
            {
                "houseName": "5栋_1单元_2001",
                "houseId": 535663,
                "unitId": 68109,
                "communityName": "美的翰诚嘉园",
                "buildId": 68105,
                "communityId": 1003837,
                "userName": "袁胜利",
                "userId": 28,
                "status": 3
            },
            {
                "houseName": "5栋_1单元_901",
                "houseId": 535719,
                "unitId": 68109,
                "communityName": "美的翰诚嘉园",
                "buildId": 68105,
                "communityId": 1003837,
                "userName": "陈羽红",
                "status": 3
            },
            {
                "houseName": "4栋_1单元_2603",
                "houseId": 535490,
                "unitId": 68108,
                "communityName": "美的翰诚嘉园",
                "buildId": 68104,
                "communityId": 1003837,
                "userName": "万春",
                "userId": 101877,
                "status": 3
            },
            {
                "houseName": "6栋_1单元_2102",
                "houseId": 537011,
                "unitId": 68110,
                "communityName": "美的翰诚嘉园",
                "buildId": 68106,
                "communityId": 1003837,
                "userName": "郑雲玲",
                "userId": 32,
                "status": 3
            },
            {
                "houseName": "6栋_1单元_503",
                "houseId": 537044,
                "unitId": 68110,
                "communityName": "美的翰诚嘉园",
                "buildId": 68106,
                "communityId": 1003837,
                "userName": "汪为正",
                "userId": 33,
                "status": 3
            },
            {
                "houseName": "6栋_1单元_503",
                "houseId": 537044,
                "unitId": 68110,
                "communityName": "美的翰诚嘉园",
                "buildId": 68106,
                "communityId": 1003837,
                "userName": "纪女士",
                "userId": 34,
                "status": 3
            },
            {
                "houseName": "8栋_1单元_1703",
                "houseId": 1610179,
                "unitId": 147311,
                "communityName": "美的翰诚嘉园",
                "buildId": 147281,
                "communityId": 1003837,
                "userName": "赵鹏举",
                "userId": 40,
                "status": 3
            },
            {
                "houseName": "4栋_1单元_1804",
                "houseId": 535455,
                "unitId": 68108,
                "communityName": "美的翰诚嘉园",
                "buildId": 68104,
                "communityId": 1003837,
                "userName": "张国兵",
                "userId": 41,
                "status": 3
            }
        ],
        "pageSize": 10
    },
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

5.4:收缴率二级页面获取本月收缴率

收缴率二级页面获取本月收缴率

请求信息

URI：https://smart-assistant-uat.smartmideazy.com/user/womCollectionRate

方法：POST

请求参数

名称 位置 类型 必填 描述
appId BODY STRING 是 应用ID
userId BODY STRING 是 用户ID
areaRemark BODY STRING 是 网格区域编码
statisticalTime BODY STRING 是 查询统计时间必传：格式：yyyyMMdd(都是传当前日期的yyyyMMdd格式字符串)

请求Body描述(非Form表单数据)

{
    "appId":"1000",
    "userId":"12546",
    "areaRemark":"HZ-YYMDWTZY-WG01",
    "statisticalTime": "20210624"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
records data JSONArray 是 响应数据对象 数组
areaName records String 是 网格名称
buildingName records String 是 建筑名称
costDate records String 是 费用账期
createTime records String 是 创建时间
communityName records String 是 项目名称
recPreYFee records String 是 实收往年累计
curAddThisYFee records String 是 本年累计应收（含本月）
statisticalTime records String 是 统计时间
curAddPreBeginYFeeNoAd records String 是 年初往年应收（不含调整）
curAddPreBeginYFee records String 是 年初往年应收（含调整/优惠）
areaRemark records String 是 网格备注
recThisYFee records String 是 实收本年累计（含本月）
recPreYFeeNoAd records String 是 实收往年累计（不含调整）

注意：第一个百分比=实收本年累计（含本月）【recThisYFee】/本年累计应收（含本月）【curAddThisYFee】

注意：第二个百分比=实收往年累计（不含调整）【recPreYFeeNoAd】/年初往年应收（不含调整）【curAddPreBeginYFeeNoAd】

注意：第三个百分比=实收往年累计【recPreYFee】/年初往年应收（含调整/优惠）【curAddPreBeginYFee】

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "areaName": "嘉园1-6栋、17-18栋",
                "buildingName": "1栋",
                "costDate": "202106",
                "createTime": "2021-06-24 15:40:31",
                "communityName": "佛山美的翰诚嘉园",
                "recPreYFee": "59920.00",
                "curAddThisYFee": "16743048.00",
                "statisticalTime": "20210624",
                "curAddPreBeginYFeeNoAd": "64920.00",
                "updateTime": "2021-06-24 15:40:31",
                "isDeleted": "0",
                "curAddPreBeginYFee": "64920.00",
                "areaRemark": "FS-HC-WG04",
                "recThisYFee": "16019047.00",
                "recPreYFeeNoAd": "59920.00"
            }
        ],
        "total": 1,
        "size": 10,
        "current": 1,
        "orders": [],
        "hitCount": false,
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

5.5:获取当前管家评价汇总统计

获取当前管家评价汇总统计

请求信息

URI：https://smart-assistant-uat.smartmideazy.com/biz/mob/eval/statistics/query/butler-detail/statistics

方法：POST

请求参数

名称 位置 类型 必填 描述
areaId BODY Integer 是 区域ID
communityId BODY Integer 是 项目ID
statisticalTime BODY String 是 统计时间：当前时间所处的年月：格式：yyyyMM

请求Body描述(非Form表单数据)

{
    "areaId":"1212007",
    "communityId":1003837,
    "statisticalTime":"202107"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
area data STRING 否 区域名称
communityName data STRING 否 项目名称
butlerName data STRING 否 管家名称
employeeName data STRING 否 员工名称
evalCount data Integer 否 评价数
evalDate data STRING 否 评价时间
ideaCount data Integer 否 记录数
likeCount data Integer 否 点赞数
sickCount data Integer 否 批评数

返回结果示例

情况一：
{
    "code": 200,
    "data": {
        "area": "1.2楼栋区域",
        "businessName": "",
        "butlerId": 1162005,
        "butlerName": "蒲公英",
        "communityId": 610,
        "communityName": "美的君兰江山（北滘）",
        "description": "",
        "employeeName": "陈结莹,陈振祥,陈健香,何伟贤,何涌,利家琪,林敏仪,李向虹,罗婵婵,路莎,赵楚碧,赵培斌",
        "evalCount": 1,
        "evalDate": "202107",
        "ideaCount": 0,
        "likeCount": 0,
        "satisfaction": "0.00",
        "sickCount": 1
    },
    "message": "success"
}

情况二：无任何评价信息
{
    "code": 200,
    "data": {},
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

5.6:评价二级页面

评价二级页面

请求信息

参考：* 8. 社区评价API

      * 25.4.2 | [管家评价记录列表](#2542) |

5.7:数据面板获取网格区域

数据面板获取网格区域

请求信息

参考：* 1. IM通讯API

      * 1.10 | [业主通讯录](#110-业主通讯录) | /imc/addressBook/get | 1.0 |

描述：根据项目ID和账号获取管理区域，返回的areaCode和areaId作为后面接口的依据凭证 { "communityId": 21322147, "userName": "maisq1" }

5.8:首页数据看板各种数量

首页数据看板各种数量

请求信息

URI：https://smart-assistant-uat.smartmideazy.com/charge/data/queryAreaPendingOrderCount

方法：POST

请求参数

名称 位置 类型 必填 描述
areaId BODY Integer 是 区域ID
communityId BODY Integer 是 项目ID
userId HEADER Integer 是 管家用户ID

请求Body描述(非Form表单数据)

{
    "areaId":"1212007",
    "communityId":1003837,
}

返回信息

{
    "code": 200,
    "data": {
        "dispatchCount": "0",
        "takeCount": "0",
        "dealCount": "0",
        "superviseCount": "0",
        "evluateCount": "0",
        "recallCount": "0"
    },
    "message": "success"
}

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
dispatchCount data STRING 否 待派单数量
takeCount data STRING 否 待接单数量
dealCount data STRING 否 待处理数量
superviseCount data STRING 否 待督办数量
evluateCount data STRING 否 待评价数量
recallCount data STRING 否 待回访数量

results matching ""

    No results matching ""