施工任务管理

施工任务管理，为施工员创建施工任务后，施工员可通过智慧工程APP或集成施工sdk的自研APP进行施工配网设备。

请求方式	API	描述
POST	/v1.0/osaas/projects/{project_id}/construction/templates/{template_id}/task	创建模板施工任务
GET	/v1.0/osaas/projects/{project_id}/construction/tasks	分页查询施工任务列表
GET	/v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}	获取施工任务详情
POST	/v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}/reopen	施工任务重开放
POST	/v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}/acceptance	验收施工任务
DELETE	/v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}	删除施工任务

创建模板施工任务

接口描述

调用该接口创建模板施工任务

接口地址

POST /v1.0/osaas/projects/{project_id}/construction/templates/{template_id}/task

请求参数

参数名	类型	参数类型	说明	是否必需
project_id	String	URI	项目唯一标识	是
template_id	String	URI	模板唯一标识	是
room_ids	String[]	BODY	房屋唯一标识列表	是
worker_id	String	BODY	施工员唯一标识	是
template_constraint	Boolean	BODY	模板约束(所以模板位置必须配网设备，默认为false)	否

响应参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13位
result	String	任务唯一标识

请求示例

POST {url}/v1.0/osaas/projects/12338239650532******/construction/templates/116082******/task

{
  "room_ids": [
    "11608239650531******"
  ],
  "worker_id": "15673345",
  "template_constraint": false
}

响应成功示例

{
  "success": true,
  "result": "123******",
  "t": 1566053034624
}

响应失败示例

{
  "code": 500,
  "msg": "system error,please contact the admin",
  "success": false,
  "t": 1561378856383
}

分页查询施工任务列表

接口描述

调用该接口分页查询施工任务列表

接口地址

GET /v1.0/osaas/projects/{project_id}/construction/tasks

请求参数

参数名	类型	参数类型	说明	是否必需
project_id	String	URI	项目唯一标识	是
page_no	Integer	URL	页码(page_no>0)(默认1)	否
page_size	Integer	URL	页条数(0<page_size<100)(默认20)	否

响应参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13位
result	Object	施工任务分页结果

result参数说明

参数名	类型	说明
total	Integer	总条数
page_no	Integer	页码
page_size	Integer	页条数
tasks	Arrays	施工任务列表

tasks参数说明

参数名	类型	说明
task_id	String	任务唯一标识
template_id	String	所属模板唯一标识
construction_ status	String	施工状态: PENDING_CONSTRUCTION:待施工 IN_CONSTRUCTION:施工中 PENDING_ACCEPTANCE:待验收 ACCEPTANCE_COMPLETE:验收完成
worker_username	String	施工员用户名
worker_nickname	String	施工员昵称
gmt_create	Long	创建时间，13 位时间戳

请求示例

GET {url}/v1.0/osaas/projects/123382396505******/construction/tasks?page_no=1&page_size=20

响应成功示例

{
  "result": {
    "total": 1,
    "page_no": 1,
    "page_size": 20,
    "tasks": [
      {
        "task_id": "130641181272348******",
        "template_id": "12554365357******",
        "worker_username": "test@tuya.com",
        "worker_nickname": "Tom",
        "construction_status": "PENDING_CONSTRUCTION",
        "gmt_create": 1600766546913
      }
    ]
  },
  "success": true,
  "t": 1572936751228
}

响应失败示例

{
  "code": 500,
  "msg": "system error,please contact the admin",
  "success": false,
  "t": 1561378856383
}

获取施工任务详情

接口描述

调用该接口获取施工任务详情

接口地址

GET /v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}

请求参数

参数名	类型	参数类型	说明	是否必需
project_id	String	URI	项目唯一标识	是
task_id	String	URI	任务唯一标识	是

响应参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13位
result	Object	施工任务详情

result参数说明

参数名	类型	说明
task_id	String	任务唯一标识
template_id	String	所属模板唯一标识
construction_ status	String	施工状态: PENDING_CONSTRUCTION:待施工 IN_CONSTRUCTION:施工中 PENDING_ACCEPTANCE:待验收 ACCEPTANCE_COMPLETE:验收完成
worker_nickname	String	施工员昵称
gmt_create	Long	创建时间，13 位时间戳
room_ids	Array	房间唯一标识列表

请求示例

GET {url}/v1.0/osaas/projects/12338239650******/construction/tasks/12677053******

响应成功示例

{
  "result": {
    "task_id": "13064118127234******",
    "template_id": "12******",
    "worker_username": "test@tuya.com",
    "worker_nickname": "张三",
    "construction_status": "PENDING_CONSTRUCTION",
    "room_ids": [
      "1255436535******"
    ],
  "gmt_create": 1600766546913
  },
  "success": true,
  "t": 1572936751228
}

响应失败示例

{
  "code": 500,
  "msg": "system error,please contact the admin",
  "success": false,
  "t": 1561378856383
}

施工任务重开放

接口描述

调用该接口施工任务重开放

接口地址

POST /v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}/reopen

请求参数

参数名	类型	参数类型	说明	是否必需
project_id	String	URI	项目唯一标识	是
task_id	String	URI	任务唯一标识	是

响应参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13位
result	Boolean	操作结果

请求示例

POST {url}/v1.0/osaas/projects/1233823965053******/construction/tasks/12677053******/reopen

响应成功示例

{
  "success": true,
  "result": true,
  "t": 1566053034624
}

响应失败示例

{
  "code": 500,
  "msg": "system error,please contact the admin",
  "success": false,
  "t": 1561378856383
}

验收施工任务

接口描述

调用该接口验收施工任务

接口地址

POST /v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}/acceptance

请求参数

参数名	类型	参数类型	说明	是否必需
project_id	String	URI	项目唯一标识	是
task_id	String	URI	任务唯一标识	是

响应参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13位
result	Boolean	操作结果

请求示例

POST {url}/v1.0/osaas/projects/1233823965053******/construction/tasks/1267705******/acceptance

响应成功示例

{
  "success": true,
  "result": true,
  "t": 1566053034624
}

响应失败示例

{
  "code": 500,
  "msg": "system error,please contact the admin",
  "success": false,
  "t": 1561378856383
}

删除施工任务

接口描述

调用该接口删除施工任务

接口地址

DELETE /v1.0/osaas/projects/{project_id}/construction/tasks/{task_id}

请求参数

参数名	类型	参数类型	说明	是否必需
project_id	String	URI	project_id 项目唯一标识	是
task_id	String	URI	task_id 任务唯一标识	是

响应参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13位
result	Boolean	操作结果

请求示例

DELETE {url}/v1.0/osaas/projects/123382396505******/construction/tasks/12677053******

响应成功示例

{
  "success": true,
  "result": true,
  "t": 1566053034624
}

响应失败示例

{
  "code": 500,
  "msg": "system error,please contact the admin",
  "success": false,
  "t": 1561378856383
}

错误码

以下为该接口常见的业务异常，更多的异常错误，请参见全局错误码。

错误码	说明
500	系统错误