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

alibaba.genie.device.operator.sync (设备组同步接口)

设备组同步接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
device_group_request DeviceGroupRequest 必须 设备组request
  • └ action
  • String
  • 必须
  • add
  • 操作动作
  • └ source
  • String
  • 必须
  • ctcc
  • 来源
  • └ name
  • String
  • 可选
  • 名称
  • 设备组名称
  • └ desc
  • String
  • 可选
  • 描述:xxx
  • 设备组描述
  • └ device_crowd_id
  • Number
  • 可选
  • 49211065728980
  • 设备组id(修改、删除必填)
  • └ file_url
  • String
  • 可选
  • https://www.xxx.com/
  • 设备组文件列表

响应参数

名称 类型 示例值 描述
ret_value Number 49211065728980 设备组id
ret_code Number 1 code码
ret_msg String 成功 msg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaGenieDeviceOperatorSyncRequest req = new AlibabaGenieDeviceOperatorSyncRequest();
AlibabaGenieDeviceOperatorSyncRequest.DeviceGroupRequest obj1 = new AlibabaGenieDeviceOperatorSyncRequest.DeviceGroupRequest();
obj1.setAction("add");
obj1.setSource("ctcc");
obj1.setName("名称");
obj1.setDesc("描述:xxx");
obj1.setDeviceCrowdId(49211065728980L);
obj1.setFileUrl("https://www.xxx.com/");
req.setDeviceGroupRequest(obj1);
AlibabaGenieDeviceOperatorSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_genie_device_operator_sync_response>
    <ret_value>49211065728980</ret_value>
    <ret_code>1</ret_code>
    <ret_msg>成功</ret_msg>
</alibaba_genie_device_operator_sync_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

返回
顶部