在鸿云文档

Appearance

设备自注册 ​

通过设备出厂时自带的设备证明去验证设备的身份获取三元组信息

主要针对一型一密的设备自注册

云平台接口地址 ​

../gateway/hmiot-device-auth-server/device/safeAutoRegister

请求方式 ​

POST

请求数据类型 ​

Content-Type: application/json

请求示例 ​

json
{
  "sign": "a6zMQHDYmt4ChtEJNS/J1VIlQEqwyj0fxNAql75DXK6Wao7TyOwK+Dj/evOvg4RQ2i7ml2tluKmxJ+ZIFQFf//odW3UKIztZV5tqhN4o81I6JzNSwIZNXMtcL4c6PkiocX4ab3//alnqstcgaErbv1ZJWvsN33+cpqjBDFM0v8xk6QRx31bJdzAk3XSwv0C8l9rIVWft5a/UvWrRw7v4qwsVyAvjdq+ZNdd/AqETJN1jAUPo40CwLN1cWUn5MzQBJmg+qgVk94tKtuII0CnvQ5fryYnSzU17dpgqDkxeZisSw8WMOFw4N0jksBInWeBL3HNs1sEQnWX9Mf6BjrqdAA==",
  "deviceUniqueNo": "202410221608",
  "signInfoVO": {
    "info": "在鸿云设备证明",
    "version": "1.0",
    "signAlg": "SHA256withRSA",
    "productSafeLevel": "1",
    "vendor": "产品品类测试_5",
    "productModel": "产品品类测试_5",
    "deviceUniqueNo": "202410221608",
    "deviceSn": "202410221608",
    "cloudId": "1848637944881950721",
    "productId": "1836229554581868545"
  }
}

请求参数说明 ​

参数名称类型
是否必选
描述
signString是签名
deviceUniqueNoString是产品下的设备唯一标识。请注意，这里的设备唯一标识，请使用设备管理平台预注册设备时约定使用的设备唯一信息，如设备的 MAC 地址、IMEI 或 SN 码等。
signInfoVOObject是设备证明信息： 通过设备注册获得
cloudIdstring是云端唯一标志符,设备授权表主键
deviceSnstring是设备 sn 号
deviceUniqueNostring是设备唯一信息编号，比如 mac 地址，sn 码等，标识设备唯一性
infostring是说明信息
productModelstring是产品型号
productSafeLevelstring是设备安全等级，参考 OpenHarmony 社区安全等级定义
signAlgstring是设备证明签名算法,摘要算法+非对称算法
vendorstring是设备生产厂商
versionstring是版本号
productIdstring是产品id

响应示例 ​

json
{
  "code": {
    "code": "0",
    "msg": "操作成功"
  },
  "result": {
    "isPreRegister": "0",
    "mqttIp": "xxx.openvalley.net",
    "mqttPort": "10040",
    "mqttsPort": "10041",
    "productKey": "a1234******",
    "deviceName": "deviceName1234",
    "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
    "deviceSecret": "adsfw******"
  }
}

响应参数说明 ​

参数名称
类型
是否必选
描述
codeObject是调用结果对象。
  codeString是0 为成功，非 0 为失败。
  msgString是此次请求结果说明，成功或失败，具体的失败原因等信息。
resultObject是返回结果数据对象。
  isPreRegisterString是1 表示已存在的设备, 0 表示新注册的设备。
  mqttIpString是MQTT 连接地址。
  mqttPortString是MQTT 的端口。
  mqttsPortString是MQTTS 的端口。
  productKeyString是产品唯一标识。
  deviceNameString是产品下的设备唯一标识。
  deviceIdString是设备 ID，用于唯一标识一个设备。如果填写该参数，平台将设备 ID 设置为该参数值；如果不填写该参数，设备 ID 由平台分配获得，生成规则为 productKey + _ + deviceName 拼接而成。
  deviceSecretString是设备密钥。