连接指南
2025/12/20大约 1 分钟
连接指南
mqtt连接TCP
{
"username": "device1&xCgOGN",
"password": "DA181D4449DAAE88C5A47681098970BE43D797EB0E513D69A7A0B09E0830EE78",
"clientId": "xCgOGN.device1|timestamp=1765676893841,signmethod=hmacsha256|",
"host": "mqtt.xiaolizi.tech",
"port": 2883,
"keepalive": 120
}mqtts连接SSL
{
"username": "device1&xCgOGN",
"password": "D44791E04D317BA85EB31E83E97F7ACDD174458E64E70F7D17AAA0AA570503CD",
"clientId": "xCgOGN.device1|timestamp=1765676933828,signmethod=hmacsha256|",
"host": "mqtts.xiaolizi.tech",
"port": 9883,
"keepalive": 120
}链接需要证书
-----BEGIN CERTIFICATE-----
MIIFATCCA+mgAwIBAgISBn7GrKhPA8iC6CrT5i8x1O3UMA0GCSqGSIb3DQEBCwUA
MDMxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBFbmNyeXB0MQwwCgYDVQQD
EwNSMTEwHhcNMjUwNzA4MTE0OTEzWhcNMjUxMDA2MTE0OTEyWjAeMRwwGgYDVQQD
ExNtcXR0cy54aWFvbGl6aS50ZWNoMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAsOcUZAvkCep9hQS4DvIVOrJb8Khvb+6O3kfFdyjsl7N7XciKSCNVO7j6
TffUqRlNmOVfDJ3vGf/XaYRmCAfSEzYYpaPyricLXfRctIpGaQCL7APw81I2LX25
3Ae6lhInZ9wDwxVsBxjqow5Kp+AhbTwpeVzxJxFBqPshzInDzFsnHtVJB0L1NhQi
w9G8eF486g60uSYE5OliKZUzBM+tHXIOdfa9yaFNA2Om9hzSAZSdCd2tDPGdwQkS
9anAhtIOWyLh/ApI6LfA0liDYBBzUW4P+MhRCTCEzumyvAHM49S4oL+lMq8ACiRn
jpNwojFZ9H5Bkbx4HyvHN9ON4n/qxQIDAQABo4ICIjCCAh4wDgYDVR0PAQH/BAQD
AgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEFBQcDAjAMBgNVHRMBAf8EAjAA
MB0GA1UdDgQWBBRsAHSdcTTi/nNIunsRgQDFBIl9YDAfBgNVHSMEGDAWgBTFz0ak
6vTDwHpslcQtsF6SLybjuTAzBggrBgEFBQcBAQQnMCUwIwYIKwYBBQUHMAKGF2h0
dHA6Ly9yMTEuaS5sZW5jci5vcmcvMB4GA1UdEQQXMBWCE21xdHRzLnhpYW9saXpp
LnRlY2gwEwYDVR0gBAwwCjAIBgZngQwBAgEwLgYDVR0fBCcwJTAjoCGgH4YdaHR0
cDovL3IxMS5jLmxlbmNyLm9yZy84NS5jcmwwggEDBgorBgEEAdZ5AgQCBIH0BIHx
AO8AdQB9WR4S4XgqexxhZ3xe/fjQh1wUoE6VnrkDL9kOjC55uAAAAZfqE+uNAAAE
AwBGMEQCIDlpnCwP/4FsrPHdCuSNSzPU35Z5t+rqVCazZz4119YlAiAYCBlWfY58
gXefW9MJWSWMcOAcu5sQxzEolbSiLZAVkgB2ABLxTjS9U3JMhAYZw48/ehP457Vi
h4icbTAFhOvlhiY6AAABl+oT81IAAAQDAEcwRQIhAP31Wm3XN/Ch/nWOxe1+qvG7
AY6ZiXfjFX0/ymFKGUocAiB7TWODy8J+wytcUR1fq/PMM8DCWBC4S/2GaA9jrm5C
nTANBgkqhkiG9w0BAQsFAAOCAQEAhCmpn3QXajrOaf8V+E+yZ/U1eDqNC4Eyra+A
3I6/K40av/2S4KPZUV5RC+qWchysXme6Fd2zjEg/q1zrmM/mrwA6+SN+wDyStacv
iFMsy+FTapOEqR+dwUIARC0HfTd/TaA5xb4a9Y3nBFOpk7n7fODO33y8ilTiXtME
zZnSXOagjDpuZG4O2oWm3vbC0IGafYHnT9xZy07zcFVhLsUCGpmfmHUD8OLf55jn
zKV59i7H9eJF118ouO6W66ucS+M9nF1yEafLQQ+JgrvNYSi5myX+G1eReNDYlAlp
qh70Tj79YRqaxTqWq6aPrW8OxcvukDeHgbSeDyqC4WME/Ia3CA==
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIFBjCCAu6gAwIBAgIRAIp9PhPWLzDvI4a9KQdrNPgwDQYJKoZIhvcNAQELBQAw
TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMjQwMzEzMDAwMDAw
WhcNMjcwMzEyMjM1OTU5WjAzMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNTGV0J3Mg
RW5jcnlwdDEMMAoGA1UEAxMDUjExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAuoe8XBsAOcvKCs3UZxD5ATylTqVhyybKUvsVAbe5KPUoHu0nsyQYOWcJ
DAjs4DqwO3cOvfPlOVRBDE6uQdaZdN5R2+97/1i9qLcT9t4x1fJyyXJqC4N0lZxG
AGQUmfOx2SLZzaiSqhwmej/+71gFewiVgdtxD4774zEJuwm+UE1fj5F2PVqdnoPy
6cRms+EGZkNIGIBloDcYmpuEMpexsr3E+BUAnSeI++JjF5ZsmydnS8TbKF5pwnnw
SVzgJFDhxLyhBax7QG0AtMJBP6dYuC/FXJuluwme8f7rsIU5/agK70XEeOtlKsLP
Xzze41xNG/cLJyuqC0J3U095ah2H2QIDAQABo4H4MIH1MA4GA1UdDwEB/wQEAwIB
hjAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwEwEgYDVR0TAQH/BAgwBgEB
/wIBADAdBgNVHQ4EFgQUxc9GpOr0w8B6bJXELbBeki8m47kwHwYDVR0jBBgwFoAU
ebRZ5nu25eQBc4AIiMgaWPbpm24wMgYIKwYBBQUHAQEEJjAkMCIGCCsGAQUFBzAC
hhZodHRwOi8veDEuaS5sZW5jci5vcmcvMBMGA1UdIAQMMAowCAYGZ4EMAQIBMCcG
A1UdHwQgMB4wHKAaoBiGFmh0dHA6Ly94MS5jLmxlbmNyLm9yZy8wDQYJKoZIhvcN
AQELBQADggIBAE7iiV0KAxyQOND1H/lxXPjDj7I3iHpvsCUf7b632IYGjukJhM1y
v4Hz/MrPU0jtvfZpQtSlET41yBOykh0FX+ou1Nj4ScOt9ZmWnO8m2OG0JAtIIE38
01S0qcYhyOE2G/93ZCkXufBL713qzXnQv5C/viOykNpKqUgxdKlEC+Hi9i2DcaR1
e9KUwQUZRhy5j/PEdEglKg3l9dtD4tuTm7kZtB8v32oOjzHTYw+7KdzdZiw/sBtn
UfhBPORNuay4pJxmY/WrhSMdzFO2q3Gu3MUBcdo27goYKjL9CTF8j/Zz55yctUoV
aneCWs/ajUX+HypkBTA+c8LGDLnWO2NKq0YD/pnARkAnYGPfUDoHR9gVSp/qRx+Z
WghiDLZsMwhN1zjtSC0uBWiugF3vTNzYIEFfaPG7Ws3jDrAMMYebQ95JQ+HIBD/R
PBuHRTBpqKlyDnkSHDHYPiNX3adPoPAcgdF3H2/W0rmoswMWgTlLn1Wu0mrks7/q
pdWfS6PJ1jty80r2VKsM/Dj3YIDfbjXKdaFU5C+8bhfJGqU3taKauuz0wHVGT3eo
6FlWkWYtbt4pgdamlwVeZEW+LM7qZEJEsMNPrfC03APKmZsJgpWCDWOKZvkZcvjV
uYkQ4omYCTX5ohy+knMjdOmdH9c7SpqEWBDC86fiNex+O0XOMEZSa8DA
-----END CERTIFICATE-----设备动态注册接口
前提条件:在管理后台-产品管理-开启动态注册开关
| HOST | iot.abplicb.top |
|---|---|
| POST | /admin-api/iot/device-info/auth/register/device |
请求数据类型 :application/json;charset=UTF-8
请求参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
|---|---|---|---|---|
| productKey | 产品key,后台管理系统获取 | json | true | string |
| deviceName | 设备名称,后台管理系统获取 | json | true | string |
| random | 随机数 | json | false | string |
| signMethod | 签名方法,固定为:hmacsha256 | json | true | string |
| sign | 签名 | json | true | string |
响应状态
| 状态码 | 说明 |
|---|---|
| 200 | OK |
| 2001000005 | 设备动态注册失败,产品未开启动态注册 |
响应参数
| 参数名称 | 参数说明 | 数据类型 |
|---|---|---|
| status | 状态码,值为0正常,其他值为异常 | int |
| code | 结果同status一样,冗余字段 | int |
| data | 创建成功返回Id | object |
| msg | 状态消息 | string |
响应示例
{
"status": 0,
"code": 0,
"data": {
},
"msg": ""
}