文档中心 > API类目 > 天猫精灵开放API

alibaba.ailabs.iot.saas.device.control (下行控制接口)

iot下行控制接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request_id String 必须 rqer31434 请求唯一标识id
application_id String 必须 faeqr3413254 应用id
service_name String 必须 timerTemperatureControl 标识符
attribute_method String 必须 thing.attribute.set 设置方法
params String 可选 feqrewr 需要设置的属性
device_id String 必须 REQTT2546WR 设备id
open_user_id String 必须 t24543tw5245 对外天猫精灵用户id
account_id String 必须 43125452 isv账号id

响应参数

名称 类型 示例值 描述
succ Boolean true 是否执行成功
message String 家居内部服务错误 错误信息
ret_value Boolean true 返回结果
ret_code Number 200 是否执行成功
trace_id String rqrtfqrqer4135425f 请求唯一标识

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabsIotSaasDeviceControlRequest req = new AlibabaAilabsIotSaasDeviceControlRequest();
req.setRequestId("rqer31434");
req.setApplicationId("faeqr3413254");
req.setServiceName("timerTemperatureControl");
req.setAttributeMethod("thing.attribute.set");
req.setParams("feqrewr");
req.setDeviceId("REQTT2546WR");
req.setOpenUserId("t24543tw5245");
req.setAccountId("43125452");
AlibabaAilabsIotSaasDeviceControlResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ailabs_iot_saas_device_control_response>
    <succ>true</succ>
    <message>家居内部服务错误</message>
    <ret_value>true</ret_value>
    <ret_code>200</ret_code>
    <trace_id>rqrtfqrqer4135425f</trace_id>
</alibaba_ailabs_iot_saas_device_control_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部