施工品类管理

施工品类。用于创建施工工单或施工模板

API 列表

请求方式	API	描述
GET	/v2.0/osaas/construction/device/categories	获取施工支持的设备品类列表
GET	/v1.0/osaas/construction/infrared/categories	获取施工支持的红外设备品类列表
GET	/v1.0/osaas/construction/split-device/categories	获取施工拆分设备品类列表

获取施工支持的设备品类列表

接口描述

调用该接口获取施工支持的设备品类列表

接口地址

GET /v2.0/osaas/construction/device/categories

响应参数

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

result参数说明

参数名	类型	说明
category	String	品类
construction_ category	String	施工品类
category_name	String	类型名称
icon	String	String 图标
type	String	类型(WIFI、ZIGBEE)

请求示例

GET {url}/v2.0/osaas/construction/device/categories

响应成功示例

{
  "success": true,
  "t": 1539776581583,
  "result": [
    {
      "category": "wfcon",
      "construction_category": "wf_zig_wfcon",
      "icon": "https://images.tuyacn.com/smart/saas/category_ic on/WangGuan.png",
      "category_name": "网关(zigbee)",
      "type": "ZIGBEE"
    }
  ]
}

响应成失败示例

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

获取施工支持的红外设备品类列表

接口描述

调用该接口获取施工支持的红外设备品类列表

接口地址

GET /v1.0/osaas/construction/infrared/categories

响应参数

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

result参数说明

参数名	类型	说明
category_id	String	类型唯一标识
category_name	String	类型名称

请求示例

GET {url}/v1.0/osaas/construction/infrared/categories

响应成功示例

{
  "success": true,
  "t": 1539776581583,
  "result": [
    {
      "category_id": "1",
      "category_name": "机顶盒"
    }
  ]
}

响应成失败示例

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

获取施工拆分设备品类列表

接口描述

调用该接口获取施工拆分设备品类列表

接口地址

GET /v1.0/osaas/construction/split-device/categories

响应参数

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

result参数说明

参数名	类型	说明
category_code	String	子设备品类编码
category_name	String	子设备品类名称

请求示例

GET {url}/v1.0/osaas/construction/split-device/categories

响应成功示例

{
  "success": true,
  "t": 1539776581583,
  "result": [
    {
      "category_code": "dj",
      "category_name": "灯光"
    }
  ]
}

响应成失败示例

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

错误码

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

错误码	说明
500	系统错误