注册设备（验证码方式）

典型场景

在设备接入物联网平台前，第三方应用需要调用此接口在物联网平台注册设备，并把设备的唯一标识码（如IMEI）设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。

接口功能

支持第三方应用在物联网平台注册设备，完成注册后设备方可接入物联网平台。

接口描述

Device::registerDevice($devicereginfoArray);

接口所属类

iotyun\huaweiiot\Device;

参数说明

$devicereginfoArray = array(
  'platformIp' => '平台IP或者域名',
  'platformPort' => '平台端口',
  'appId' => '应用appId',
  'accessToken' => '你系统存储的accessToken',
    'rddInArray' => array(
                'deviceInfoArray' => array(
                    'manufacturerId' => '',
                    'manufacturerName' => '',
                    'deviceType' => '',
                    'model' => '',
                    'protocolType' => ''
                ),
                'imsi' => '',
                'isSecure' => '',
                'verifyCode' => '',
                'nodeId' => '',
                'endUserId' => '',
                //'psk' => '',
                'timeout' => 0,
                'productId' => ''
        )
);

rddInArray：

说明：
如果用户需要注册安全设备，isSecure参数必须填写。 | | verifyCode | 可选 | String(256) | 设备验证码，全局唯一，建议与nodeId设置成相同值。若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。
在NB-IoT方案中，verifyCode为必填参数，且必须与nodeId设置成相同值。 | | nodeId | 必选 | String(256) | 设备的唯一标识，必须与设备上报的设备标识一致。通常使用MAC地址，Serial No或IMEI作为nodeId。
说明：
使用IMEI作为nodeId时，根据不同厂家的芯片有不同填写要求。
- 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号
- 海思芯片设备的唯一标识为IMEI号
- 其他厂家芯片的设备唯一标识请联系模组厂家确认。
| | endUserId | 可选 | String(256) | 终端用户ID。
在NB-IoT方案中，endUserId设置为设备的IMSI号。在Smarthome解决方案中， endUserId设置为App账号。 | | psk | 可选 | String(8~32) | 请求中指定psk，则平台使用指定的psk；请求中不指定psk，则由平台生成psk。取值范围是a-f、A-F、0-9组成的字符串。 | | timeout | 可选 | Integer(>=0) | 超时时间。当调用API接口对设备开户，在超时时间内可绑定设备，若超过timeout时间且未绑定设备，则会删除超时的开户信息。
取值范围：0～2147483647。若填写为“0”，则表示设备验证码不会失效（建议填写为“0”）。
默认值：“0”(默认值可配置，具体配置值请咨询物联网平台运维人员。)
单位：秒。 | | productId | 可选 | String(256) | 设备所属的产品ID。 |

deviceInfoArray:

返回值

RegDirectDeviceOutDTO

错误码

使用说明

经过测试，如果同一nodeId多次注册设备，物联网平台会删除以前的设备，重新注册新的设备，原设备下的数据会丢失，因此如果不想删除原来设备重新添加，不要使用同一nodeId重复注册设备。