淘宝开放平台

登录
文档中心 > API类目 > 阿里大于通信能力包

alibaba.aliqin.fc.iot.device.post (商家提交设备信息)

物联网商家设备信息录入

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
imei String 必须 123456789012345 15位imei号
device_type String 可选 deviceType 设备类型（将来扩展）
comments String 可选 备注 备注
mid_pat_channel String 可选 扩展字段 扩展字段

响应参数

名称 类型 示例值 描述
result Result result
  • └ model
  • String
  • true
  • 响应结果描述
  • └ code
  • String
  • 0
  • 响应code 判断以此判断是否提交成功
  • └ success
  • Boolean
  • true
  • 是否异常
  • └ msg
  • String
  • 成功
  • 返回描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinFcIotDevicePostRequest req = new AlibabaAliqinFcIotDevicePostRequest();
req.setImei("123456789012345");
req.setDeviceType("deviceType");
req.setComments("备注");
req.setMidPatChannel("扩展字段");
AlibabaAliqinFcIotDevicePostResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
<alibaba_aliqin_fc_iot_device_post_response>
    <result>
        <model>true</model>
        <code>0</code>
        <success>true</success>
        <msg>成功</msg>
    </result>
</alibaba_aliqin_fc_iot_device_post_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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_ERR 参数非法 请核对入参
isv.PERMISSION_ERR 调用方只能对自己的数据完成操作 核对入参信息，确保信息正确
isv.NOT_FOUND_CUST 客户资料不存在 客户资料不存在,请核对入参信息
isv.IMEI_ERR imei非法 录入正确的imei信息
isv.IMEI_EXIST 设备已经存在 已存在的设备，请勿重复提交
isv.SYSTEM_ERR 系统异常 系统异常，联系技术支持
isv.PORD_PERMISSION 未开通依赖产品，请开通后再调用 请开通响应的产品，
isv.FORBIDDEN_ACTION 不支持的操作（当前API不支持授权调用/当前API必须授权调用） 确认调用账号是否对于此API有授权调用，物联卡业务不支持授权调用

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部