閱讀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_阿裏雲物聯網套件-阿裏雲