在鸿云文档Appearance
三方设备注册
接口地址
/gateway/hmsafe-service/hmsafe-third-device/register
请求方式
POST
请求数据类型
application/json
请求示例
json
{
"deviceSn": "13546546852",
"deviceUniqueNo": "202310081751",
"productId": "1710955480599281665",
"publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAopMTrO5jeSQ79Cluh4mmCHtux2a+B9tObsRHPurb5eDTkwxUYJCR+Ey6HwcwY3/oX1Fc7zTeUI1+B1cukgQ54UoDjp7hhFqk+G7z6B9pFriBP2OPE3d/xx+dx37qkfxOJbvv90hKh7JYMHRK2Vnx6odRDxEpqtL/2ppGWeZ5JZgulnbEMxNlv3+mG43Gl7yKEDQCuDzjiw0DRIZ180GhIEmAvMkhTqdbDRW8o/1OfWFcq1b439vqG9qWfJpOTzUtOalPN1DwFIRbyEYwknhK8ZoGfR3B5BcZ9duL+5t0FvTumoTxFTQsqHMr0yjw1ndsdj62yb+RishAsxNdW5bCSQIDAQAB"
"deviceDesc": "备注信息"
}请求参数:
| 参数名称 | 参数说明 | in | 是否必须 | 数据类型 |
|---|---|---|---|---|
| deviceSn | 设备序列号 | true | string | |
| deviceUniqueNo | 设备唯一信息编号，比如 mac 地址，sn 码等，标识设备唯一性 | true | string | |
| productId | 产品 id | true | string | |
| publicKey | 设备公钥 | true | string | |
| deviceDesc | 设备备注信息 | false | string |
响应状态:
| 状态码 | 说明 |
|---|---|
| 200 | OK |
| 201 | Created |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 |
|---|---|---|
| code | Object | |
| code | string | |
| msg | string | |
| ok | boolean | |
| result | Object | |
| deviceCert | 设备证书 | string |
| deviceName | 设备名称 | string |
| deviceProveVO | 设备证明 | Object |
| sign | 签名 | string |
| signInfoVO | 设备签名信息 | Object |
| 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": "202310081751",
"tenantCert": "-----BEGIN CERTIFICATE-----\nMIIC+zCCAeOgAwIBAgIEKQwhXjANBgkqhkiG9w0BAQsFADAbMRkwFwYDVQQDDBBSb290IENlcnRpZmljYXRlMCAXDTIzMTAwODA5NTAwM1oYDzIwNTMxMDA4MDk1MDAzWjAbMRkwFwYDVQQDDBBSb290IENlcnRpZmljYXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw7Iq8WEvRedE4lxTl6lmYlO58L9Wo42zVFOM3F0BxkH1hBWr6m06OLZrjH7ZFl94AvYWYTIgWjReHLhzhF9Ec7u06QKbFBpH/oWmXbFeppFYVa0DWLcrPm5tMQ6QoCZPnNb3WUtwUx3R+xDDvOOpCrlS6E4R0QH4MVmvJ/41T8pCVZOWwEOkutx+rNzzBfiK05QbhXHf5y5aIeaVgGI8Mmp3o/JnEm8icyFqNGSrjrNmUUl9NIyGzquujfzbIFx2z+AT8XBDpTGpeB2BbbcMAM1D4rm98tS94fYsX55n6RrBkGFdagbrR+Z/IMu4QGQHIyR5iea0/Bpax2Lyy2l/nwIDAQABo0UwQzAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ4EBwQFVDAwNDMwEAYDVR0jBAkwB4AFVDAwNDMwDQYJKoZIhvcNAQELBQADggEBAC33f28qQUnhDcfYtz3C8LKo4/hNIpoUOdyeV+ak7WI31IcYS20nv9DSCgV9i1cDw/VsT3KXpqI0viMAuGgv+0+QR5uJN16aUdoK70bSSo0xSH/Uex7lLTY0/aBirbn7nEs0G0FgcuQSb2UBWpjlVzpv+DqCjah8xc3pnWf8X/DRdKQZMS1/PUgHpUCp5hEG3+vTX602HIffExZ3V2htwHFE5DoBjp/K18KjzaSrpMYVq9RK+xneMlz65XgVFJOdMdVVTGjU8ST0jI9cfR9jS+OPj6ut281HMebebrNoGR5VZa1PkViLqoyMO21AUBVMKM2xvxiWxZiQGFIOCuVrbVc=\n-----END CERTIFICATE-----",
"productCert": "-----BEGIN CERTIFICATE-----\nMIIDATCCAemgAwIBAgIE9QZrUDANBgkqhkiG9w0BAQsFADAbMRkwFwYDVQQDDBBSb290IENlcnRpZmljYXRlMB4XDTIzMTAwODA5NTAwNFoXDTI2MTAwODA5NTAwNFowIzEhMB8GA1UEAwwYSW50ZXJtZWRpYXRlIENlcnRpZmljYXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApuuNcwNUA3KyqaK5ldB++Lxa1l7mw0Gb1XJJ2HL//xgGJblX5JM+1QG/5V61kObmWoLX4EIezo0lLe87punD3bYg4JxGgVmeTa4Fj4z2CSDW4Du7/MAY0wIiIDgrzJSZXTs28IwNOUZgKoorXb+iaqeN+tsb7ldRWEDJTNQTlgpgyqZfAqH9YcmwOzHZ/KTIo/TCmZRO7IWFHyiv079emgC/CC2CJLVdolCrUfwJnkYb6mMjnh4X1Xo9MpolylkD6OIHGp3JOPBSjeidV8JHyL1QmMkRcvAb8qkvi3kGmFi9pmOw0x+a1Z+F9JdlQBIaH6dv8Otq4MCyfu4jiJjaawIDAQABo0UwQzAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ4EBwQFVDAwNDMwEAYDVR0jBAkwB4AFVDAwNDMwDQYJKoZIhvcNAQELBQADggEBAJ54aqp3fw7mUFftvxdq8F1c1fn/VPdjmgQFIFewjSfXQqEneF4OCQPn3A3MVrD6zMBRdWtaeW9lPFOexL3vSgMb4MPABi1s/m2F4u8/tOsyAgQhqEdXFzIFoy3Bxmw/T97Jc2MjrmM4+0/J+JIOJhOorK9u4wrjfsgnhw3lr46R2bxuEKCJxQBIp5/sE5eLY50yJlkw0km6V49r4qHKFioDV0Zu4Zh0Ca1r/lZwW+x19jBi8ImMsLIGwwWcFzZNr0+xM5BdWmXIFl9cmV4tpqI7sn0+1/lB88AH6SuzDT78bZsnRu8QPSDaqPutOinAcZ3UB26uSfAjemGCUXjPBEQ=\n-----END CERTIFICATE-----",
"deviceCert": "-----BEGIN CERTIFICATE-----\nMIIDBzCCAe+gAwIBAgIEfkdQ5DANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhJbnRlcm1lZGlhdGUgQ2VydGlmaWNhdGUwHhcNMjMxMDA4MDk1MjEyWhcNMjYxMDA4MDk1MjEyWjAhMR8wHQYDVQQDDBZFbmQgRW50aXR5IENlcnRpZmljYXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAopMTrO5jeSQ79Cluh4mmCHtux2a+B9tObsRHPurb5eDTkwxUYJCR+Ey6HwcwY3/oX1Fc7zTeUI1+B1cukgQ54UoDjp7hhFqk+G7z6B9pFriBP2OPE3d/xx+dx37qkfxOJbvv90hKh7JYMHRK2Vnx6odRDxEpqtL/2ppGWeZ5JZgulnbEMxNlv3+mG43Gl7yKEDQCuDzjiw0DRIZ180GhIEmAvMkhTqdbDRW8o/1OfWFcq1b439vqG9qWfJpOTzUtOalPN1DwFIRbyEYwknhK8ZoGfR3B5BcZ9duL+5t0FvTumoTxFTQsqHMr0yjw1ndsdj62yb+RishAsxNdW5bCSQIDAQABo0UwQzAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ4EBwQFVDAwNDMwEAYDVR0jBAkwB4AFVDAwNDMwDQYJKoZIhvcNAQELBQADggEBAHvtlGEIAM8kUwA1DwknTGMvMl4Bs1xNI0jbUPyhTeiYVkAbj4ilM5T4Em2oFmDXdkwqjQvfWRq/w6Y3RYebYAjWt63QL/fADf1SqT1aYO0IwBZ9WUm+Oz+6hwJSkT8maRnCkOsYwTOd1sOup4Nbbm4nuwePodd+tFUkac8AwjiSBMTlhUzy24N7ScHsLXVlChbZUH0JKC4KUYRWCdsCjWEMN9bTM8S2j8pEpnO3JKfGnjUmslpjULCzovAQg6JJ9+1n908xDEk0BY4DscVr/wzID/0ptao1PfDoFN++OptE1OOa3JwWFUsIb1B0/UpUOgeXtBzXiueDpk5CyQriKgk=\n-----END CERTIFICATE-----",
"deviceProveVO": {
"signInfoVO": {
"info": "在鸿云设备证明",
"version": "1.0",
"signAlg": "SHA256withRSA",
"productSafeLevel": "2",
"vendor": "开鸿智谷",
"productModel": "第三方产品",
"deviceUniqueNo": "202310081751",
"deviceSn": "13546546852",
"cloudId": "1710956247930421250",
"productId": "1710955480599281665"
},
"sign": "e45e7oa7wvxzz72beO34EfIN9GSQ1wFc8GMUxuwI6FGkoGEnfMUjPOqc1gkdIIov+YWz+EGxPAIorlX3F+M2q07zXfEcWmgSk+beBK4ZfnH1sJCS62YLN2cmxs+UsHZxaK1dnTo/toJ/3uY3BKBLdnISvnaDJN17zVnzEeLb1NEOtzhpxUDf41013pNXqWcW7clYAESNOrCzx0PFdIhWe/cWUD9dQ8J5xPFjWo01Ku4RLEPVLJRULPsnzNi/gxd8AgHqzQUzhDbaSqMSfuFcS8UI6GvX44K7uq9UoRIs562KZnbkmg3z02DzsSixrSd+6uyTpwIXqAyz3heXlZ9dcA=="
}
}
}