aliyun.alink.userdata.post (物联平台用户数据上报)

该API用于接入了物联SDK的APP,将用户相关数据上报给物联平台

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
input AlkTopPostUserDataReqPayload 必须 输入参数
  • └ vendor_user_id
  • String
  • 可选
  • 38907410
  • 商户私有账户体系里的用户唯一标识
  • └ device_model
  • String
  • 可选
  • DREAMMAKER_HEALTH_AIRPURIFIER_DM260S01_i
  • 设备型号
  • data_list
  • AlkTopUserData []
  • 必须
  • 数据列表
  • └ unit
  • String
  • 可选
  • kg
  • 数据属性单位
  • └ value
  • String
  • 必须
  • 71.6
  • 数据属性值
  • └ attribute
  • String
  • 必须
  • weight
  • 数据属性
  • └ data_collect_time
  • Number
  • 必须
  • 1425343683
  • 数据采集时间, UTC时间,为自1970年1月1日0 时0分0秒以来的秒数
  • └ data_upload_time
  • Number
  • 可选
  • 1425343689
  • 默认值:0
  • 数据上传时间, UTC时间, 为自1970年1月1日0时 0分0秒以来的秒数
  • └ device_id
  • String
  • 可选
  • 36FE3F7A4B331A0E7C8D9BA74B85F1B5
  • 设备的唯一标识符

响应参数

名称 类型 示例值 描述
operation_success Boolean true 调用状态
data AlkTopUserDataResp 返回数据
  • └ status_code
  • Number
  • 0
  • 返回状态码
  • └ message
  • String
  • 调用成功
  • 返回信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliyunAlinkUserdataPostRequest req = new AliyunAlinkUserdataPostRequest();
AlkTopPostUserDataReqPayload obj1 = new AlkTopPostUserDataReqPayload();
obj1.setVendorUserId("38907410");
obj1.setDeviceModel("DREAMMAKER_HEALTH_AIRPURIFIER_DM260S01_i");
List<AlkTopUserData> list3 = new ArrayList<AlkTopUserData>();
AlkTopUserData obj4 = new AlkTopUserData();
list3.add(obj4);
obj4.setUnit("kg");
obj4.setValue("71.6");
obj4.setAttribute("weight");
obj4.setDataCollectTime(1425343683L);
obj4.setDataUploadTime(1425343689L);
obj1.setDataList(list3);
obj1.setDeviceId("36FE3F7A4B331A0E7C8D9BA74B85F1B5");
req.setInput(obj1);
AliyunAlinkUserdataPostResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliyun_alink_userdata_post_response>
    <operation_success>true</operation_success>
    <data>
        <status_code>0</status_code>
        <message>调用成功</message>
    </data>
</aliyun_alink_userdata_post_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>

错误码解释

错误码 错误描述 解决方案
isv.param-error 输入参数错误 检查输入参数
isv.sys-error 系统错误 重试

API工具

如何获得此API

FAQ

返回
顶部