在鸿云文档Appearance
设备注册
接口地址
/gateway/hmsafe-service/hmsafe-device-auth/genericRegister
请求方式
POST
请求数据类型
application/json
请求示例
json
{
"productId": "1788012662654144514",
"deviceUniqueNo": "202405080907",
"deviceSn": "202405080907",
"publicKey": "MIIBCgKCAQEA7t3zRtflZtabju+3gge553UPMp27uZ9HdhFjweyAxnitZstyIj+H 4qNpg7Chs0mLPlH1iD4jflzLbePsDqcJkkY7Ys3p2qL21WzJ0j2m+Varad3mxJYV ysbMh/FN2GaS80Wm6cD6p3FtYheOTOMCh6vTpt3MEaXTmVYvKtGf0s+3SKTpWmci NdBuZOo7qjZocBXEp/F9QR5IXptRGP2y6r1tAWylDhvz6erZ8+A90YcQ3PAey1ru XjiwnyczI2/2BWlfM3Tk09jfGfgsS5Mi+nDTG3UJvLhwFnBW0Z98Me44UCpqMADm mk5JzHcMhmECkSARZD1Y9r2qgAofDSLvdwIDAQAB",
"deviceDesc": "测试"
}请求参数
| 参数名称 | 参数说明 | in | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| deviceDesc | 设备备注信息 | false | string | ||
| deviceSn | 设备序列号 | false | string | ||
| deviceUniqueNo | 设备唯一信息编号，比如mac地址，sn码等，标识设备唯一性 | false | string | ||
| productId | 产品id：安全的产品管理界面可以看到 | false | string | ||
| publicKey | 设备公钥 | false | string |
响应状态
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | AResultCode | AResultCode | |
| code | string | ||
| msg | string | ||
| ok | boolean | ||
| result | HmsafeDeviceCertVO | HmsafeDeviceCertVO | |
| deviceCert | 设备证书 | string | |
| deviceName | 设备名称 | string | |
| deviceProveVO | 设备证明 | DeviceProveVO | DeviceProveVO |
| sign | 签名 | string | |
| signInfoVO | 设备签名信息 | DeviceSignInfoVO | DeviceSignInfoVO |
| cloudId | 云端唯一标志符,设备授权表主键 | string | |
| deviceSn | 设备sn号 | string | |
| deviceUniqueNo | 设备唯一信息编号，标识设备唯一性 | string | |
| info | 说明信息 | string | |
| productId | 产品id | string | |
| productModel | 产品型号 | string | |
| productSafeLevel | 设备安全等级，参考OpenHarmony社区安全等级定义 | string | |
| signAlg | 设备证明签名算法,摘要算法+非对称算法 | string | |
| vendor | 设备生产厂商 | string | |
| version | 版本号 | string | |
| productCert | 产品证书 | string | |
| tenantCert | 租户证书 | string |
响应示例
json
{
"code": {
"code": "0",
"msg": "操作成功",
"ok": true
},
"result": {
"deviceName": "202403061355",
"tenantCert": "-----BEGIN CERTIFICATE-----\nMIIC+zCCAeOgAwIBAgIEdyGN6zANBgkqhkiG9w0BAQsFADAbMRkwFwYDVQQDDBBSb290IENlcnRpZmljYXRlMCAXDTI0MDIyMDAzMzQyNloYDzIwNTQwMjIwMDMzNDI2WjAbMRkwFwYDVQQDDBBSb290IENlcnRpZmljYXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4J4UKZFV84ud/y5ciXAZMqqL6jQaxQsY65js6BaULboFwHAZadM/3gyJpdPdgpqrowARkrtnvAM5RBnAJoTV0JXa63i9NXrEkZs5rqBIVa216noviZf3w8beK0/reUTgphWuDNLyF+PF5aiPn0OId7lghwHJG+5SF8Uy8muxVsHeNDz5CwViCkYDdGAr/LNNAPKWuvsEvCh8AUiqhdGRStw3rwEe0rLCqX4eC5lr5mcAhgYGRMZLqBz1/v3QBAdEdFn7ZLk3xOlN0M7Yb4mKCUP0ApVBmtHzJGIELYOj844gY09j+NkkOVN5mmcNIFgVAYxHCVGTEe8mWaOJv+l1AQIDAQABo0UwQzAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ4EBwQFVDAwNDIwEAYDVR0jBAkwB4AFVDAwNDIwDQYJKoZIhvcNAQELBQADggEBAHfLAoNEOTH0gSz57sGheuCq84EzKi6zW/r06P3tv+s3sE+XRYbvI+ntTREZs9UX7CkCJ/Y4u0b8EMhz4vjB1P9VIfXRheVez1fMDmT/EG/DDSodEXw+Izq5wzr34sF7TMjT1NKTpVF+7moWdelmkFDv/ioRJE5APnEhkC3K84dS4YH5ZMlXuqhheCT6eGg8wOW5Y8HRFs22cbc/a5DluHFk6FcXauoFa5X5O5YXuNuWh01DA14BuzV8tkre3y5QoSAwpO1biYdBJ8BJR5t3xKSGpJ5sOsibrSwR6rUQpb6wobG0K5YbGHsI8lxs069ZuiOZtGpFCEKuL06XDFhRa34=\n-----END CERTIFICATE-----",
"productCert": "-----BEGIN CERTIFICATE-----\nMIIDATCCAemgAwIBAgIEFc6VezANBgkqhkiG9w0BAQsFADAbMRkwFwYDVQQDDBBSb290IENlcnRpZmljYXRlMB4XDTI0MDMwNjAzMzkwN1oXDTI3MDMwNjAzMzkwN1owIzEhMB8GA1UEAwwYSW50ZXJtZWRpYXRlIENlcnRpZmljYXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1qkzYZ1LiUJRGTniNQEiPtAJjmY9g4gD4X6rIbUaz+qSYAmsfLCVL763PcTCBMtAymmnZi5DnVdHLt5atPHLo8NjKM4G5Kr4VxjC52sO6ZCveio7d7CdJHYYtHbwPP/VsNSKkkNBEm4d/ZsRMe2zIHi4okpf5/Kdq0BmgsMzLxEEB41+tWeu0lNOR/cd5w3q7qfqlfPVdcJkOhdKimL1YtVpSm7Y3/o49k0cLOmhWeKQUqf5lbuOMC0Bl8MkVVGxkHGXy6r7KGf6LJMEIkz7vkalCeg/W6mtN0NkFD/8tCqV4HjL/lFBEBTpoJ+5s1rL33w25X2Ecmh8wnIMUUKnYwIDAQABo0UwQzAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ4EBwQFVDAwNDIwEAYDVR0jBAkwB4AFVDAwNDIwDQYJKoZIhvcNAQELBQADggEBAImzSeazQY7A7cZ3YyodL3cCPfeZc8qBu6+9XiUI4nf0enIv1Tfkk6Iwu5tsoYGnMTfjbE2hMiKUnXg3PmgNhHv56jTllosytlq6sSzI+ziuI3LT/7WxFtE4msTlrmnkfIje5QIqYtS39ZcKvJ0iP9ysPvDI9eLeIX4S+ZBXv4If0gCjy7whRozuoGlaX0AT3PNg5DAhw5uPrvkVNmpYgkaSlXWyVsg+fxbSuswEAPNzCZHLj7IHiXxDlCAXlCLMdN1XuGYT/PmVYZKAfsaG6bTiJCR7OIPuCADUN8LeMkWGQ1eAkpWS8pSqMMexWcpIcbsdrHSURm8gKlaVUT+nSZ8=\n-----END CERTIFICATE-----",
"deviceCert": "-----BEGIN CERTIFICATE-----\nMIIDBzCCAe+gAwIBAgIEkQWoATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhJbnRlcm1lZGlhdGUgQ2VydGlmaWNhdGUwHhcNMjQwMzA2MDU1NzIyWhcNMjcwMzA2MDU1NzIyWjAhMR8wHQYDVQQDDBZFbmQgRW50aXR5IENlcnRpZmljYXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv8zQ2giTIfGhy3evvmElECIir9SxDZnQrbvx6tYacxFe+FVVAH0FLVFfbl2x64NCRiQqt57at1tAu5WIa0YhmiFP07N274hPmdmRqE5F6qcNQDTbbmxC26HxEvp8p71ww3YD6k/qCY+pwpjMbMOpT8Zf7AuR0FD3+ss6kpVlCLc+exDACrRgeazDMBtSKf9PL9ZXx8D3PYYy/ZyRmZ5Bcmhez82CWlJBtt9LjA7twjNRkwalajmWnkfgIBWcCJq9LhOURBCReuC6IHMvSvs+yzNUdNLu+Sl4L4y4Uf8dgtctFQ+pwCs+2Q+l/KXgZwG/zmocmqcSkgxUgYuQqTJu8wIDAQABo0UwQzAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ4EBwQFVDAwNDIwEAYDVR0jBAkwB4AFVDAwNDIwDQYJKoZIhvcNAQELBQADggEBAHKEPb3ZYkpOSONnDVW3IoDZqIcU+F6y30VizbTRV+JUlXu4GXR+5z/93Mxp0riCFDw/KSg7Uhz7mR5rl+Ctj0WZnz7xsVo7TJghfMM72P6bi8C/+uVoYG6KUIlFmw+g/jUxHGP3KPiCr9JYd7srX8zc7h/Y11uBHoT/nZx7Q6MXed18w55LIkKXGPELCSU70EB0GtMPd03CT2HuDUiXIWzaV+pgZN31E/tIo0h44pNCmQLR5uvRyCnrsatLheEYjnJTmpsl3QdLEGXTgrv06BGiIwjhOd1wLhzDHSgtkIivKNiOZlXbItmn1dt5tmxtzsCpIA1evwSiYRcDhGKIE3s=\n-----END CERTIFICATE-----",
"deviceProveVO": {
"signInfoVO": {
"info": "在鸿云设备证明",
"version": "1.0",
"signAlg": "SHA256withRSA",
"productSafeLevel": "1",
"vendor": "123",
"productModel": "123",
"deviceUniqueNo": "202403061355",
"deviceSn": "202403061355",
"cloudId": "1765255333085388802",
"productId": "25648730102a4403a3619aa0a48a694d"
},
"sign": "MtT799fiA+SSrmkEvkJz78z5GAz5gG2MojlJUM/3WA5ZAGWDL1U3rTsko92u4b6LcaZt4QxP4h6xLF9bqCsVdkwoFWiZv6NZrSni7HZfeF9RpRQQ66QRd7wT8833FHOrU1eq59v3IrQi81yJAHEzcx/QIegKFzSgWRhaMSAJufiDZN7j9xaNfd5rlodSCn1J5jqE3JD+hOuBioJa3QKwhVNRwAkUt8kd3aBG//Co4mxYCn6rYF7xnd2RklXJSLxx6Tv7ga+GY6NyXn/wbftXu/bEIXw+RCg244r1lVutZjGT+5h/LrREDWjlUqbLIS44gXXFEVTRH1OSS1+EKlOa2A=="
}
}
}