注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 阿里大于API

alibaba.aliqin.fc.iot.modbind (物联网绑定/换绑API)

支持用户的设备的换绑和解绑操作

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
opion_type String 必须 chgBind chgBind:换绑;unBind:解绑
bill_real String 必须 4567867897890 物联卡和iccid保持一致
iccid String 必须 4567867897890 iccid (20位)
newimei String 可选 12312ss 换绑的时候必传,换的新设备imei
imei String 必须 12312ss 目前绑定的设备imei
bill_source String 必须 ICCID 物联卡业务:若无特殊为ICCID
mid_pat_channel String 必须 122 若无特殊物联卡传入122

响应参数

名称 类型 示例值 描述
result Result result
  • └ model
  • String
  • true
  • model
  • └ code
  • String
  • 0
  • code
  • └ success
  • Boolean
  • true
  • success
  • └ msg
  • String
  • 正常
  • msg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinFcIotModbindRequest req = new AlibabaAliqinFcIotModbindRequest();
req.setOpionType("chgBind");
req.setBillReal("4567867897890");
req.setIccid("4567867897890");
req.setNewimei("12312ss");
req.setImei("12312ss");
req.setBillSource("ICCID");
req.setMidPatChannel("122");
AlibabaAliqinFcIotModbindResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_aliqin_fc_iot_modbind_response>
    <result>
        <model>true</model>
        <code>0</code>
        <success>true</success>
        <msg>正常</msg>
    </result>
</alibaba_aliqin_fc_iot_modbind_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.BIND_NOT_EXIST 绑定记录不存在 请确认要换绑和解绑的卡和设备信息
isv.PERMISSION_OPT 发起查询者不是该卡开户归属者,无权操作 请确认归属关系,再发起操作
isv.RES_NOT_EXIST 资源不存在 请确认当前录入的imei是否合法
isv.OPATION_ERR 操作类型不支持 请录入正确的操作
isv.PARAM_ERR 参数不合法 请确认参数是否正确
isv.SYS_ERR 系统异常 请联系技术支持
isv.NOT_ACTIVE 用户未激活 用户未激活
isv.QUERY_ASSETS_ERROR 查询用户信息异常 请确认物联卡号和发起调用的账号是否正确
isv.FORBIDDEN_ACTION 不支持的操作(当前API不支持授权调用/当前API必须授权调用) 确认调用账号是否对于此API有授权调用,物联卡业务不支持授权调用
isv.OWNER_CUST_NOT_MATCH 您无法对不属于自己的卡进行操作 请确认调用账号是否正确,操作的物联卡号是否正确

API工具

如何获得此API

FAQ

返回
顶部