调用该接口查询设备的食谱制作状态。该接口仅在云食谱应用中使用。

接口名称 mtop.alibaba.aicloud.recipe.getDeviceCurrentStatus
版本号 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 String model的子参数。接口返回码。此处返回的是字符串对像,需要先通过JSON.parse处理。
retValue JSON model的子参数。服务端对设备端下发的控制指令的返回列表。
contentRecipeId String 内容食谱ID。
deviceId String 设备ID。
runStatus Integer 食谱的运行状态。取值如下。
- 0:停止
- 1:运行
- 2:暂停
- 3:食谱完成
- 4:中断暂停
totalTimeleft Integer 剩余时间总时间,单位:秒。
productName String 产品名称
productKey String 产品key
controlApiName String 控制接口名
deviceStatusApiName String 设备状态接口名
businessRecipeId String 行业食谱ID。
totalTime Integer 总时间,单位秒。
deviceStatus JSON 设备状态。
interruptErrorInfo JSON 食谱中断的错误码。
extentions String model的子参数。扩展参数,暂未启用,可忽略。
statusCode Object 接口返回码。与retCode参数的值相同,200表示成功。

示例

请求示例

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

返回示例

  1. "api": "mtop.alibaba.aicloud.recipe.getDeviceCurrentStatus",
  2. "data": {
  3. "success": "true",
  4. "model": {
  5. "retCode": 200, // 这里返回的是字符串对像,需要先通过JSON.parse处理
  6. "retValue": {
  7. "contentRecipeId": 1137111, // 内容食谱id
  8. "currentContentRecipeStepId": 9420204, // 当前食谱步骤id
  9. "deviceId": "a80171320100009715c507da78000000", // 设备id
  10. "runStatus": 1, // 运行状态,0 停止 1 运行 2 暂停 3 食谱完成 4 中断暂停
  11. "totalTimeleft": 180, // 剩余时间总时间,单位秒
  12. "productName": "智能LED灯泡", // 产品名称
  13. "productKey": "306", // 产品key
  14. "controlApiName": "alibaba.ailabs.iot.saas.devicecontrol", // 控制接口名
  15. "deviceStatusApiName": "alibaba.ailabs.iot.saas.deviceStatus", // 设备状态接口名
  16. "businessRecipeId": 100, // 行业食谱id
  17. "totalTime": 180 // 总时间,单位秒
  18. "deviceStatus": {"name":"start/开始","value":1} // 设备状态
  19. "interruptErrorInfo": {"code": 302007,"message":"设备处于离线状态"} // 中断错误码
  20. },
  21. "extentions": null
  22. },
  23. "statusCode": "200"
  24. }
  25. }