调用该接口查询行业设备的控制状态。

接口名称 mtop.alibaba.aicloud.recipe.businessDeviceControl
版本号 1.0

请求参数

名称 参数类型 是否必填 描述
devId String 是 设备的ID。H5 SDK自动填写，您无需关注。
productKey String 是 产品的Key，设备证书信息之一。创建产品时，生活物联网平台为该产品颁发的全局唯一标识。H5 SDK自动填写，您无需关注。
params String 是 请求参数列表。
openAccountId String 是 params的子参数。用户账号的accountId。您可以在SaaS平台的应用开发 > 开发管理中查看。
controlApiName String 是 params的子参数。控制接口名。调用接口可获取该参数的值。
releaseStatus Number 是 params的子参数。表示发布的环境。取值范围如下。
- 1：预发环境
- 2：线上环境
domain Number 是 params的子参数。目前仅云食谱中使用该参数，固定配置为1。
payload Object 是 params的子参数。领域参数，请参见使用该接口的详细描述。

返回参数

名称 参数类型 描述
success Boolean 请求的响应结果。
model String 返回参数列表。
retCode Object model的子参数。接口返回码。200表示成功。
retValue Boolean model的子参数。服务端对设备端下发的控制指令是否成功。取值范围如下。
- true：成功
- false：失败
extentions String model的子参数。扩展参数，暂未启用，可忽略。
statusCode Object 接口返回码。与retCode参数的值相同，200表示成功。

示例

请求示例

  1. AI.aiRequestMtopProxy({
  2.     api: 'mtop.alibaba.aicloud.recipe.businessDeviceControl',
  3.     data: {
  4.         devId: AI.devId,
  5.         productKey: AI.productKey,
  6.         params: JSON.stringify({
  7.           openAccountId: "0yl8oK0*****xSMD4g==",
  8.           controlApiName: "alibaba.ailabs.iot.saas.devicecontrol",
  9.           releaseStatus: 2,
  10.           releaseVersion: null,
  11.           domain: 1,
  12.           payload: JSON.stringify({"businessRecipeId": 100,"command":"deviceStart"})
  13.         })
  14.     }
  15. }).then((res) => {
  16.     console.log('返回信息', res);
  17. }).catch((res) => {
  18.     console.log('失败返回', res);
  19. });

返回示例

  1. {
  2.   "api": "mtop.alibaba.aicloud.recipe.businessDeviceControl",
  3.   "data": {
  4.     "success": "true",
  5.     "model": {
  6.       "retCode": 200,
  7.       "success": true,
  8.       "retValue": true,
  9.       "extentions": null
  10.     },
  11.     "statusCode": "200"
  12.   }
  13. }

错误码

错误码 描述
302002 productKey为13414的产品不支持属性为workSwitch的功能定义。
302003 该账号下没有天猫精灵可以推送指令。
302007 设备处于离线状态。
302030 音箱不在线，无法推送指令。
120010 其他食谱正在制作中。
120017 您的操作太快了。

取消