阅读644 返回首页    go 魔兽


设备注册__接口列表_服务器端API_阿里云物联网套件-阿里云

描述

本接口为 2016-05-30版本新发布接口。使用场景:用户通过服务器端生成设备。目前只支持单个设备生成。

请求参数

名称 类型 是否必须 描述
<公共参数> 公共参数
ProductKey String 产品的product AppKey
DeviceName String 自定义设备名称,不传则由系统生成默认与deviceId一致

返回参数

名称 类型 描述
RequestId String 当前请求在阿里云产生的请求ID
Success Boolean 表示调用成功与否
ErrorMessage String 错误信息
DeviceId String 阿里云颁发的设备id,全局唯一
DeviceName String 设备名称,产品内唯一,由用户自定义,如果重复将返回已有产品,如果不指定则返回deviceId
DeviceSecret String 设备私钥
DeviceStatus String 设备状态,目前预留

示例

  • 请求示例
  1. https://iot.aliyuncs.com/?&Action=RegistDevice
  2. &ProductKey=...
  3. &<[公共请求参数]>
  • SDK示例代码 [SDK下载]

    • java

      1. RegistDeviceRequest request = new RegistDeviceRequest();
      2. request.setProductKey("xxxxxx");
      3. request.setDeviceName("xxxxx");//可以设空,如果名称为空则由阿里云生成设备名称默认与设备id一致。设备名称在产品内唯一,如果已存在则返回已有设备
      4. RegistDeviceResponse resp = client.getAcsResponse(request);
      5. System.out.println(resp.getSuccess());
      6. System.out.println(resp.getErrorMessage());
      7. System.out.println(resp.getDeviceSecret());
      8. System.out.println(resp.getDeviceId());
      9. System.out.println(resp.getDeviceName());
    • php

    • python

      1. request = RegistDeviceRequest.RegistDeviceRequest()
      2. request.set_accept_format('json') // 设置返回数据格式,默认为XML
      3. request.set_ProductKey('xxxxxxx')
      4. request.set_DeviceName('xxxxxxx') // 可以设空,如果名称为空则由阿里云生成设备名称默认与设备id一致。设备名称在产品内唯一,如果已存在则返回已有设备
      5. result = clt.do_action(request)
      6. print 'regist device : ' + result
  • 返回示例

    json示例

  1. {
  2. "RequestId":"120F5EB3-7023-4F0C-B419-9303AB336885",
  3. "Success":true
  4. "DeviceId":"", //阿里云颁发的设备id 全局唯一
  5. "DeviceName":"",//设备名称,用户自定义或系统生成
  6. "DeviceSecret":"",//设备私钥
  7. "DeviceStatus":"",//预留状态字段
  8. "ErrorMessage":""//错误信息
  9. }
  • 常见错误

    未授权操作

    这种错误信息一般是由于 调用SDK时候,填写的accessKeyId和accessSecret与你指定的productKey的创建者不是用一个用户导致的。 注册设备的时候,需要使用当前ProductKey的创建者对应的accessKey和accessSecret才有效.

最后更新:2016-12-06 17:27:48

  上一篇:go 查询产品的设备列表__接口列表_服务器端API_阿里云物联网套件-阿里云
  下一篇:go 申请批量生成设备__接口列表_服务器端API_阿里云物联网套件-阿里云