4. 已下发任务API

API列表

编号 API名称 路径 版本
4.1 获取已下发任务列表 /v1/iot/task/task-info/query/page 1.0
4.2 获取已下发任务详情 /v1/iot/task/task-info/detail 1.0
4.3 APP获取任务汇总的设备列表 /v1/iot/task/task-info/app/device-list 1.0
4.4 App根据设备编码当前登录角色获取设备下的任务列表 /v1/iot/task/task-info/app/page 1.0
4.5 App项目工程主管指派任务 /v1/iot/task/task-info/app/assign 1.0
4.6 App项目员工领取任务 /v1/iot/task/task-info/app/receive 1.0
4.7 App项目员工处理任务 /v1/iot/task/task-info/app/handle 1.0
4.8 App选择任务关联任务的技能标签关联的员工 /v1/iot/task/task-info/app/group/admin-user 1.0
4.9 APP获取当前项目的空间 /v1/iot/main/space/tree/org/{biz_org_id} 1.0
4.10 APP获取项目设备专业 /v1/iot/device/setting/list 1.0
4.11 已下发任务导出接口 /biz/mob/report/csv/exportCsvTaskInfo 1.0
4.12 下载任务的检查报告 /v1/iot/task/task-info/downloadDetailPdf 1.0

API调用

4.1: 获取已下发任务列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/query/page

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
pageSize body int y 分页数
pageNo body int y 页码
name body string N 标准名称
code body string N 标准编码
deviceCode body string N 设备编码
cycleCode body string N 周期编码
operatorName body string N 操作人名称
deviceCategoryId body int N 设备分类id
groupId body string N 技能标签ID
fromTime body DATE n 计划开始时间开始
toTime body DATE N 计划开始时间结束

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

{
    "pageSize":20,
    "pageNo":1,
    "communityId":21146
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
total data Intger 是 总条数
pages data Intger 是 总页数
pageNo data Intger 是 当前页码
pageSize data Intger 是 页数
recodes data JSONArray 是 记录对象
taskInfoId recodes Intger 是 任务ID
taskTemplateId recodes Intger 是 任务标准ID
name recodes STRING 是 任务名称
code recodes STRING 是 任务编码
deviceCategoryId recodes Intger 是 设备分类ID
deviceCategoryName recodes STRING 是 设备分类名称
settingPartId recodes Intger 是 部件ID
settingPartName recodes STRING 是 部件名称
deviceCode recodes STRING 是 设备编码
deviceName recodes STRING 是 设备名称
cycleCode recodes STRING 是 周期编码
cycleName recodes STRING 是 周期名称
planStartTime recodes DATE 是 计划开始时间
planEndTime recodes DATE 是 计划结束时间
actualStartTime recodes DATE 是 实际任务开始时间
actualEndTime recodes DATE 是 实际任务结束时间
taskStatus recodes STRING 是 任务状态："WAIT_ASSIGN"："待指派"；"PENDING"："待处理"；"PROCESSED"："已处理"；
termStatus recodes STRING 是 期限状态："NOT_EXPIRED"："未超期"；"EXPIRED"："已超期";
valueType recodes STRING 是 结果类型： 1：判断（正常or异常） 2：数字范围 3：写文本
firstValue recodes STRING 是 第一个值 （正常 or 正常数值起始值 or 文本内容）
secondValue recodes STRING 是 第二个值 （正常 or 正常数值结束值 or 文本内容）
valueResult recodes STRING 是 处理结果
isPicture recodes STRING 是 是否有图片
isExceptionMark recodes STRING 是 师傅异常备注
remark recodes STRING 是 处理备注
isDeal recodes STRING 是 是否已处理
workerNo recodes STRING 是 工单号
taskGroupRelations recodes JSONArray 是 关联技能标签
groupName taskGroupRelations STRING 是 标签名称
parentGroupName taskGroupRelations STRING 是 标签的专业名称
taskResultImgs recodes JSONArray 否 关联的图片地址
imgUrl taskResultImgs STRING 是 图片地址
taskUsers recodes JSONArray 否 关联的协助人
name taskUsers STRING 是 协助人名称
返回结果示例
{
    "code": 200,
    "data": {
        "total": 6,
        "pages": 1,
        "recodes": [
            {
                "taskInfoId": 6,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000004",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS5-2",
                "deviceName": "风扇5",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:11",
                "updateTime": "2021-10-28 10:47:11",
                "versionNum": 0,
                "deleteFlag": 0,
                "taskGroupRelations": [
                    {
                        "taskInfoId": 6,
                        "groupId": 86835,
                        "groupLevel": 2,
                        "groupName": "公共设施",
                        "parentGroupId": 86834,
                        "parentGroupName": "工程"
                    }
                ]
            },
            {
                "taskInfoId": 7,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000005",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS1A-2",
                "deviceName": "风扇1a",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:11",
                "updateTime": "2021-10-28 10:47:11",
                "versionNum": 0,
                "deleteFlag": 0,
                "taskGroupRelations": [
                    {
                        "taskInfoId": 7,
                        "groupId": 86835,
                        "groupLevel": 2,
                        "groupName": "公共设施",
                        "parentGroupId": 86834,
                        "parentGroupName": "工程"
                    }
                ]
            },
            {
                "taskInfoId": 8,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000006",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS1A333-1",
                "deviceName": "风扇1a333",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:11",
                "updateTime": "2021-10-28 10:47:11",
                "versionNum": 0,
                "deleteFlag": 0,
                "taskGroupRelations": [
                    {
                        "taskInfoId": 8,
                        "groupId": 86835,
                        "groupLevel": 2,
                        "groupName": "公共设施",
                        "parentGroupId": 86834,
                        "parentGroupName": "工程"
                    }
                ]
            },
            {
                "taskInfoId": 9,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000007",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS1A333-2",
                "deviceName": "风扇1a333",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:11",
                "updateTime": "2021-10-28 10:47:11",
                "versionNum": 0,
                "deleteFlag": 0,
                "taskGroupRelations": [
                    {
                        "taskInfoId": 9,
                        "groupId": 86835,
                        "groupLevel": 2,
                        "groupName": "公共设施",
                        "parentGroupId": 86834,
                        "parentGroupName": "工程"
                    }
                ]
            },
            {
                "taskInfoId": 10,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000008",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS1A-3",
                "deviceName": "风扇1a",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:11",
                "updateTime": "2021-10-28 10:47:11",
                "versionNum": 0,
                "deleteFlag": 0,
                "taskGroupRelations": [
                    {
                        "taskInfoId": 10,
                        "groupId": 86835,
                        "groupLevel": 2,
                        "groupName": "公共设施",
                        "parentGroupId": 86834,
                        "parentGroupName": "工程"
                    }
                ]
            },
            {
                "taskInfoId": 5,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000003",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS5-1",
                "deviceName": "风扇5",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:10",
                "updateTime": "2021-10-28 10:47:10",
                "versionNum": 0,
                "deleteFlag": 0,
                "taskGroupRelations": [
                    {
                        "taskInfoId": 5,
                        "groupId": 86835,
                        "groupLevel": 2,
                        "groupName": "公共设施",
                        "parentGroupId": 86834,
                        "parentGroupName": "工程"
                    }
                ]
            }
        ],
        "pageNo": 1,
        "pageSize": 20
    },
    "message": "success"
}

4.2: 获取已下发任务详情

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/detail

方法：POST

请求参数

名称 位置 类型 必填 描述
taskInfoId body Long y 选中的任务ID

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

{
    "taskInfoId":6
}

返回信息

{
    "code": 200,
    "data": {},
    "message": "success"
}
返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
taskInfoId data Intger 是 任务ID
taskTemplateId data Intger 是 任务标准ID
name data STRING 是 任务名称
code data STRING 是 任务编码
deviceCategoryId data Intger 是 设备分类ID
deviceCategoryName data STRING 是 设备分类名称
settingPartId data Intger 是 部件ID
settingPartName data STRING 是 部件名称
deviceCode data STRING 是 设备编码
deviceName data STRING 是 设备名称
cycleCode data STRING 是 周期编码
cycleName data STRING 是 周期名称
planStartTime data DATE 是 计划开始时间
planEndTime data DATE 是 计划结束时间
actualStartTime data DATE 是 实际任务开始时间
actualEndTime data DATE 是 实际任务结束时间
taskStatus data STRING 是 任务状态："WAIT_ASSIGN"："待指派"；"PENDING"："待处理"；"PROCESSED"："已处理"；
termStatus data STRING 是 期限状态："NOT_EXPIRED"："未超期"；"EXPIRED"："已超期";
valueType data STRING 是 结果类型： 1：判断（正常or异常） 2：数字范围 3：写文本
firstValue data STRING 是 第一个值 （正常 or 正常数值起始值 or 文本内容）
secondValue data STRING 是 第二个值 （正常 or 正常数值结束值 or 文本内容）
valueResult data STRING 是 处理结果
isPicture data STRING 是 是否有图片
isExceptionMark data STRING 是 师傅异常备注
remark recodes STRING 是 处理备注
isDeal data STRING 是 是否已处理
workerNo data STRING 是 工单号
taskGroupRelations data JSONArray 是 关联技能标签
groupName taskGroupRelations STRING 是 标签名称
parentGroupName taskGroupRelations STRING 是 标签的专业名称
taskResultImgs data JSONArray 否 关联的图片地址
imgUrl taskResultImgs STRING 是 图片地址
taskUsers data JSONArray 否 关联的协助人
name taskUsers STRING 是 协助人名称
返回结果示例
{
    "code": 200,
    "data": {
        "taskInfoId": 6,
        "taskTemplateId": 36,
        "name": "2021年11月工程-公共设施管理任务",
        "code": "GSHY-20211028-000004",
        "deviceCategoryId": 29,
        "deviceCategoryName": "生活水泵111",
        "settingPartId": 9,
        "settingPartName": "定子绕组",
        "deviceCode": "JPS-JSXT-FS5-2",
        "deviceName": "风扇5",
        "cycleCode": "WEEK",
        "cycleName": "周",
        "taskValue": "2",
        "planStartTime": "2021-10-28 00:00:00",
        "planEndTime": "2021-11-06 23:59:59",
        "taskStatus": "WAIT_ASSIGN",
        "termStatus": "NOT_EXPIRED",
        "valueType": "1",
        "firstValue": "SUCCESS",
        "secondValue": "ERROR",
        "isPicture": "Y",
        "isExceptionMark": "Y",
        "isDeal": "N",
        "communityId": 21146,
        "communityName": "广厦花园",
        "businessOrgCode": "100000001100000006",
        "businessOrgId": 21135,
        "createTime": "2021-10-28 10:47:11",
        "updateTime": "2021-10-28 10:47:11",
        "versionNum": 0,
        "deleteFlag": 0,
        "taskGroupRelations": [
            {
                "taskInfoId": 6,
                "groupId": 86835,
                "groupLevel": 2,
                "groupName": "公共设施",
                "parentGroupId": 86834,
                "parentGroupName": "工程"
            }
        ]
    },
    "message": "success"
}

4.3: APP获取任务汇总的设备列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/app/device-list

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
orgId body Long y 业务组织ID
pageSize body int y 分页数
pageNo body int y 页码
name body string N 标准名称
deviceCategoryId body int N 设备分类id
groupId body string N 技能标签ID
fromTime body DATE n 计划开始时间开始
toTime body DATE N 计划开始时间结束

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

{
    "pageSize":20,
    "pageNo":1,
    "communityId":21146,
    "orgId":21135
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
total data Intger 是 总条数
pages data Intger 是 总页数
pageNo data Intger 是 当前页码
pageSize data Intger 是 页数
recodes data JSONArray 是 记录对象
deviceCategoryId recodes Intger 是 设备分类ID
deviceCategoryName recodes STRING 是 设备分类名称
deviceCode recodes STRING 是 设备编码
deviceName recodes STRING 是 设备名称
返回结果示例
{
    "code": 200,
    "data": {
        "total": 6,
        "pages": 1,
        "recodes": [
            {
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "deviceCode": "JPS-JSXT-FS1A-2",
                "deviceName": "风扇1a"
            },
            {
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "deviceCode": "JPS-JSXT-FS1A-3",
                "deviceName": "风扇1a"
            },
            {
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "deviceCode": "JPS-JSXT-FS1A333-1",
                "deviceName": "风扇1a333"
            },
            {
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "deviceCode": "JPS-JSXT-FS1A333-2",
                "deviceName": "风扇1a333"
            },
            {
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "deviceCode": "JPS-JSXT-FS5-1",
                "deviceName": "风扇5"
            },
            {
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "deviceCode": "JPS-JSXT-FS5-2",
                "deviceName": "风扇5"
            }
        ],
        "pageNo": 1,
        "pageSize": 20
    },
    "message": "success"
}

4.4: App根据设备编码当前登录角色获取设备下的任务列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/app/page

方法：POST

请求参数

名称 位置 类型 必填 描述
orgId body Long y 业务组织ID
communityId body Long y 项目小区Id
deviceCode body int y 必传
name body string N 标准名称
deviceCategoryId body int N 设备分类id
taskStatus body string N "WAIT_ASSIGN"："待指派"【指派任务列表/领取任务列表】； "PENDING"："待处理"【待处理任务列表，员工进去该页面只能查自己领取的或被指派的任务中未处理的任务】 "PROCESSED"："已处理"【已处理任务列表，员工进去该页面只能查自己领取的或被指派的任务中已处理的任务】

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

{
    "communityId":21146,
    "deviceCode":"JPS-JSXT-FS5-1",
    "orgId":21135

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
recodes data JSONArray 是 记录对象
taskInfoId recodes Intger 是 任务ID
taskTemplateId recodes Intger 是 任务标准ID
name recodes STRING 是 任务名称
code recodes STRING 是 任务编码
deviceCategoryId recodes Intger 是 设备分类ID
deviceCategoryName recodes STRING 是 设备分类名称
settingPartId recodes Intger 是 部件ID
settingPartName recodes STRING 是 部件名称
deviceCode recodes STRING 是 设备编码
deviceName recodes STRING 是 设备名称
cycleCode recodes STRING 是 周期编码
cycleName recodes STRING 是 周期名称
planStartTime recodes DATE 是 计划开始时间
planEndTime recodes DATE 是 计划结束时间
actualStartTime recodes DATE 是 实际任务开始时间
actualEndTime recodes DATE 是 实际任务结束时间
taskStatus recodes STRING 是 任务状态："WAIT_ASSIGN"："待指派"；"PENDING"："待处理"；"PROCESSED"："已处理"；
termStatus recodes STRING 是 期限状态："NOT_EXPIRED"："未超期"；"EXPIRED"："已超期";
valueType recodes STRING 是 结果类型： 1：判断（正常or异常） 2：数字范围 3：写文本
firstValue recodes STRING 是 第一个值 （正常 or 正常数值起始值 or 文本内容）
secondValue recodes STRING 是 第二个值 （正常 or 正常数值结束值 or 文本内容）
valueResult recodes STRING 是 处理结果
isPicture recodes STRING 是 是否有图片
isExceptionMark recodes STRING 是 师傅异常备注
remark recodes STRING 是 处理备注
isDeal recodes STRING 是 是否已处理
workerNo recodes STRING 是 工单号
taskGroupRelations recodes JSONArray 是 关联技能标签
groupName taskGroupRelations STRING 是 标签名称
parentGroupName taskGroupRelations STRING 是 标签的专业名称
taskResultImgs recodes JSONArray 否 关联的图片地址
imgUrl taskResultImgs STRING 是 图片地址
taskUsers recodes JSONArray 否 关联的协助人
name taskUsers STRING 是 协助人名称
返回结果示例
{
    "code": 200,
    "data": {
        "recodes": [
            {
                "taskInfoId": 5,
                "taskTemplateId": 36,
                "name": "2021年11月工程-公共设施管理任务",
                "code": "GSHY-20211028-000003",
                "deviceCategoryId": 29,
                "deviceCategoryName": "生活水泵111",
                "settingPartId": 9,
                "settingPartName": "定子绕组",
                "deviceCode": "JPS-JSXT-FS5-1",
                "deviceName": "风扇5",
                "cycleCode": "WEEK",
                "cycleName": "周",
                "taskValue": "2",
                "planStartTime": "2021-10-28 00:00:00",
                "planEndTime": "2021-11-06 23:59:59",
                "taskStatus": "WAIT_ASSIGN",
                "termStatus": "NOT_EXPIRED",
                "valueType": "1",
                "firstValue": "SUCCESS",
                "secondValue": "ERROR",
                "isPicture": "Y",
                "isExceptionMark": "Y",
                "isDeal": "N",
                "communityId": 21146,
                "communityName": "广厦花园",
                "businessOrgCode": "100000001100000006",
                "businessOrgId": 21135,
                "createTime": "2021-10-28 10:47:10",
                "updateTime": "2021-10-28 10:47:10",
                "versionNum": 0,
                "deleteFlag": 0
            }
        ],
        "isProjectEnginee": false
    },
    "message": "success"
}

4.5: App项目工程主管指派任务

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/app/assign

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
orgId body Long y 业务组织ID
adminId body Long y 要指派的员工ID，一次只能指派一个员工
ids body string y 要指派的任务ID，多个任务逗号隔开

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

{
    "communityId":21146,
    "orgId":21135,
    "adminId":87801,
    "ids":"6,7"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
返回结果示例
情况一：
{
    "code": 0,
    "data": {},
    "message": "您不具备项目工程主管权限,不能指派任务！"
}
情况二：
{
    "msgId": null,
    "code": 0,
    "message": "请选择要指派的任务！"
}
情况三：
{
    "msgId": null,
    "code": 0,
    "message": "任务已被领取或指派，请重新选择任务！"
}
情况4：
{
    "code": 200,
    "data": {},
    "message": "成功指派1条任务"
}

4.6: App项目员工领取任务

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/app/receive

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
orgId body Long y 业务组织ID
ids body string y 要领取的任务ID，多个任务逗号隔开

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

{
    "communityId":21146,
    "orgId":21135,
    "ids":"7"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
返回结果示例
情况一：
{
    "code": 0,
    "data": {},
    "message": "存在不可领取任务，请重新选择任务！"
}
情况二：
{
    "msgId": null,
    "code": 0,
    "message": "暂无符合的任务可领取，请重新选择任务！"
}
情况三：
{
    "msgId": null,
    "code": 0,
    "message": "任务已被领取或指派，请重新选择任务！"
}
情况4：
{
    "code": 200,
    "data": {},
    "message": "成功领取1条任务"
}

4.7: App项目员工处理任务

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/app/handle

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
orgId body Long y 业务组织ID
taskInfos body JSONArray y 要处理的任务，最多1000条
taskInfoId taskInfos Long y 任务信息ID
isDeal taskInfos String y 是否已处理：Y：已处理，不转工单 N：转工单
workNo taskInfos String y 转工单号
valueResult taskInfos String y 处理结果： 1：判断（Y/N） 2：数字范围 3：写文本
remark taskInfos String y isExceptionMark=Y的时候，这个字段不能为空
taskResultImgs taskInfos JSONArray y 处理的结果图片集
imgUrl taskResultImgs String y 图片地址
taskUsers taskInfos JSONArray y 协助人
adminId taskUsers Long y 协助人ID

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

{
    "communityId":21146,
    "orgId":21135,
    "taskInfos":[{
        "taskInfoId":7,
        "isDeal":"Y",
        "valueResult":"Y",
        "remark":"数据一切正常",
        "taskResultImgs":[{"imgUrl":"https://iot-xlink-xfile.oss-cn-hangzhou.aliyuncs.com/community/2021-01-15/16106906591280.png"},
                          {"imgUrl":"https://mideazy-test-public.oss-cn-hangzhou.aliyuncs.com/iot_box_image/175f329c753-1606102402899.jpg"}],
        "taskUsers":[{"adminId":87799},
                     {"adminId":87799}]
    }]
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
返回结果示例
情况1：
{
    "code": 200,
    "data": {},
    "message": "成功处理任务：成功1条，失败0条"
}

4.8: App选择任务关联任务的技能标签关联的员工

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/app/group/admin-user

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
orgId body Long y 业务组织ID
taskInfoIds body string y 要领取的任务ID，多个任务逗号隔开

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

{
    "communityId":21146,
    "orgId":21135,
    "taskInfoIds":"5,6,7,8,9"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
total data Intger 是 总条数
pages data Intger 是 总页数
pageNo data Intger 是 当前页码
pageSize data Intger 是 页数
recodes data JSONArray 是 记录对象
adminName recodes String 是 员工名称
groupName recodes String 是 技能标签名称
groupId recodes Long 是 技能标签ID
adminId recodes Long 是 员工ID
返回结果示例
{
    "code": 200,
    "data": {
        "total": 1,
        "pages": 1,
        "recodes": [
            {
                "adminName": "裴珍",
                "groupName": "工程-公共设施",
                "groupId": 86835,
                "adminId": 87801
            }
        ],
        "pageNo": 1,
        "pageSize": 10
    },
    "message": "success"
}

4.9: APP获取当前项目的空间

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/main/space/tree/org/21135 【后面的是当前项目的orgId】

方法：POST

请求参数

名称 位置 类型 必填 描述

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

{
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
trees 顶层 JSONArray 是 响应数据对象
tree trees JSONArray 是 总条数
space_name tree String 是 空间名称
space_code tree String 是 空间编码
space_type tree String 是 空间类型，COMMUNITY：项目
返回结果示例
{
    "code": "200",
    "message": "成功",
    "version": null,
    "returnExceptionData": false,
    "trees": [
        {
            "tree": [
                {
                    "create_by": null,
                    "update_by": null,
                    "create_time": 1608795511000,
                    "update_time": 1608796643000,
                    "id": 21146,
                    "parentid": null,
                    "space_id": null,
                    "parent_space_id": null,
                    "community_id": null,
                    "space_name": "广厦花园",
                    "full_space_name": "广厦花园",
                    "parent_code": null,
                    "space_code": "100001013",
                    "space_type": "COMMUNITY",
                    "space_sort": "COMMUNITY",
                    "org_code": "100000001100000006",
                    "business_type": 1,
                    "src": 1,
                    "org_id": 21135,
                    "top_org_id": 15264,
                    "top_org_code": "100000001",
                    "status": 1,
                    "area": null,
                    "fee_area": null,
                    "business_code": null,
                    "logic_deleted": null,
                    "top_org_name": null,
                    "hasRelated": null,
                    "province": null,
                    "city": null,
                    "district": null,
                    "detail": null,
                    "lon": 0.0,
                    "lat": 0.0,
                    "children": [
                        {
                            "create_by": null,
                            "update_by": null,
                            "create_time": 1633942129000,
                            "update_time": 1633942129000,
                            "id": 86824,
                            "parentid": 21146,
                            "space_id": null,
                            "parent_space_id": null,
                            "community_id": null,
                            "space_name": "yy",
                            "full_space_name": "广厦花园/yy",
                            "parent_code": "100001013",
                            "space_code": "100001013100000000",
                            "space_type": "ZONE",
                            "space_sort": "ZONE",
                            "org_code": null,
                            "business_type": null,
                            "src": 1,
                            "org_id": null,
                            "top_org_id": null,
                            "top_org_code": null,
                            "status": 2,
                            "area": null,
                            "fee_area": null,
                            "business_code": null,
                            "logic_deleted": 1,
                            "top_org_name": null,
                            "hasRelated": null,
                            "province": null,
                            "city": null,
                            "district": null,
                            "detail": null,
                            "lon": 0.0,
                            "lat": 0.0,
                            "children": [
                                {
                                    "create_by": null,
                                    "update_by": null,
                                    "create_time": 1633942138000,
                                    "update_time": 1633942138000,
                                    "id": 86825,
                                    "parentid": 86824,
                                    "space_id": null,
                                    "parent_space_id": null,
                                    "community_id": null,
                                    "space_name": "建筑物",
                                    "full_space_name": "广厦花园/yy/建筑物",
                                    "parent_code": "100001013100000000",
                                    "space_code": "100001013100000000100000000",
                                    "space_type": "STRUCTURE",
                                    "space_sort": "STRUCTURE",
                                    "org_code": null,
                                    "business_type": null,
                                    "src": 1,
                                    "org_id": null,
                                    "top_org_id": null,
                                    "top_org_code": null,
                                    "status": 2,
                                    "area": null,
                                    "fee_area": null,
                                    "business_code": null,
                                    "logic_deleted": 1,
                                    "top_org_name": null,
                                    "hasRelated": null,
                                    "province": null,
                                    "city": null,
                                    "district": null,
                                    "detail": null,
                                    "lon": 0.0,
                                    "lat": 0.0,
                                    "children": null,
                                    "parent_name": null,
                                    "org_ids": null,
                                    "pageNo": 0,
                                    "pageSize": 0,
                                    "list": null,
                                    "org_id_name": null,
                                    "orgName": null,
                                    "authOrg": null,
                                    "orderby": null,
                                    "directChildrenNums": 0,
                                    "directZoneNums": 0,
                                    "directPhysicalSpaceNums": 0,
                                    "is_super": null,
                                    "orgCode": null,
                                    "oldRelOrgId": null,
                                    "selected": false,
                                    "_only_sub": true
                                },
                                {
                                    "create_by": null,
                                    "update_by": null,
                                    "create_time": 1633942138000,
                                    "update_time": 1633942138000,
                                    "id": 86826,
                                    "parentid": 86824,
                                    "space_id": null,
                                    "parent_space_id": null,
                                    "community_id": null,
                                    "space_name": "车场",
                                    "full_space_name": "广厦花园/yy/车场",
                                    "parent_code": "100001013100000000",
                                    "space_code": "100001013100000000100000001",
                                    "space_type": "PARK",
                                    "space_sort": "PARK",
                                    "org_code": null,
                                    "business_type": null,
                                    "src": 1,
                                    "org_id": null,
                                    "top_org_id": null,
                                    "top_org_code": null,
                                    "status": 2,
                                    "area": null,
                                    "fee_area": null,
                                    "business_code": null,
                                    "logic_deleted": 1,
                                    "top_org_name": null,
                                    "hasRelated": null,
                                    "province": null,
                                    "city": null,
                                    "district": null,
                                    "detail": null,
                                    "lon": 0.0,
                                    "lat": 0.0,
                                    "children": null,
                                    "parent_name": null,
                                    "org_ids": null,
                                    "pageNo": 0,
                                    "pageSize": 0,
                                    "list": null,
                                    "org_id_name": null,
                                    "orgName": null,
                                    "authOrg": null,
                                    "orderby": null,
                                    "directChildrenNums": 0,
                                    "directZoneNums": 0,
                                    "directPhysicalSpaceNums": 0,
                                    "is_super": null,
                                    "orgCode": null,
                                    "oldRelOrgId": null,
                                    "selected": false,
                                    "_only_sub": true
                                },
                                {
                                    "create_by": null,
                                    "update_by": null,
                                    "create_time": 1633942138000,
                                    "update_time": 1633942138000,
                                    "id": 86827,
                                    "parentid": 86824,
                                    "space_id": null,
                                    "parent_space_id": null,
                                    "community_id": null,
                                    "space_name": "公共区域",
                                    "full_space_name": "广厦花园/yy/公共区域",
                                    "parent_code": "100001013100000000",
                                    "space_code": "100001013100000000100000002",
                                    "space_type": "PUBLIC_AREA",
                                    "space_sort": "PUBLIC_AREA",
                                    "org_code": null,
                                    "business_type": null,
                                    "src": 1,
                                    "org_id": null,
                                    "top_org_id": null,
                                    "top_org_code": null,
                                    "status": 2,
                                    "area": null,
                                    "fee_area": null,
                                    "business_code": null,
                                    "logic_deleted": 1,
                                    "top_org_name": null,
                                    "hasRelated": null,
                                    "province": null,
                                    "city": null,
                                    "district": null,
                                    "detail": null,
                                    "lon": 0.0,
                                    "lat": 0.0,
                                    "children": null,
                                    "parent_name": null,
                                    "org_ids": null,
                                    "pageNo": 0,
                                    "pageSize": 0,
                                    "list": null,
                                    "org_id_name": null,
                                    "orgName": null,
                                    "authOrg": null,
                                    "orderby": null,
                                    "directChildrenNums": 0,
                                    "directZoneNums": 0,
                                    "directPhysicalSpaceNums": 0,
                                    "is_super": null,
                                    "orgCode": null,
                                    "oldRelOrgId": null,
                                    "selected": false,
                                    "_only_sub": true
                                }
                            ],
                            "parent_name": null,
                            "org_ids": null,
                            "pageNo": 0,
                            "pageSize": 0,
                            "list": null,
                            "org_id_name": null,
                            "orgName": null,
                            "authOrg": null,
                            "orderby": null,
                            "directChildrenNums": 0,
                            "directZoneNums": 0,
                            "directPhysicalSpaceNums": 0,
                            "is_super": null,
                            "orgCode": null,
                            "oldRelOrgId": null,
                            "selected": false,
                            "_only_sub": true
                        }
                    ],
                    "parent_name": null,
                    "org_ids": null,
                    "pageNo": 0,
                    "pageSize": 0,
                    "list": null,
                    "org_id_name": null,
                    "orgName": null,
                    "authOrg": null,
                    "orderby": null,
                    "directChildrenNums": 0,
                    "directZoneNums": 0,
                    "directPhysicalSpaceNums": 0,
                    "is_super": null,
                    "orgCode": null,
                    "oldRelOrgId": null,
                    "selected": false,
                    "_only_sub": true
                }
            ]
        }
    ],
    "menus": null,
    "role": null
}

4.10: APP获取项目设备专业

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/setting/list

方法：POST

请求参数

名称 位置 类型 必填 描述
grade 顶层 Integer 是 等级【传死的1】

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

{
    "grade":1
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 JSONObject 是 响应数据对象
records data JSONArray 是 总条数
space_name tree String 是 空间名称
space_code tree String 是 空间编码
space_type tree String 是 空间类型，COMMUNITY：项目
返回结果示例
{
    "code": 200,
    "data": {
        "records": [
            {
                "createBy": null,
                "createTime": "2021-09-28 14:52:44",
                "updateBy": null,
                "grade": 1,
                "name": "第一层级测试",
                "pid": 0,
                "typeId": null,
                "updateTime": "2021-10-08 17:26:23",
                "id": 194,
                "orgId": "1"
            }
        ]
    },
    "message": "success"
}

4.11: 已下发任务导出

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/biz/mob/report/csv/exportCsvTaskInfo

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId body Long y 项目小区Id
name body string N 标准名称
deviceCategoryId body int N 设备分类id
groupId body string N 技能标签ID
fromTime body DATE n 计划开始时间开始
toTime body DATE N 计划开始时间结束

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

返回信息

返回参数类型

返回参数

返回结果示例

导出：导出的是一个.csv的文件【类excel】

异常返回示例

{"code":400,"message":"暂无信息","data":{}}

4.12: 下载任务的检查报告

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/task/task-info/downloadDetailPdf

方法：POST

请求参数

名称 位置 类型 必填 描述
taskInfoId body Long y 下载任务的Id

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

返回信息

返回参数类型

返回参数

返回结果示例

导出：下载的是一个.pdf的文件】

异常返回示例

{"code":400,"message":"暂无信息","data":{}}

results matching ""

    No results matching ""