1签名规则

未登录的所有接口（包括登录接口）调用都需要计算签名，签名值放在请求头的 Authorization参数中。

是 Postman 中的 变量占位符，表示：读取当前作用域中名为 sign 的变量值，并在发送请求前替换成真实内容。 # 2登录 URL：/v2/user/login 请求方法：POST 认证参数：Sign 入参： | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | --- | ---------------------------------- | | lang | String | 否 | 推送通知语言，`cn` 表示中文，`en` 表示英文，默认 `en` | | countryCode | String | 是 | 电话区号，必须以 `+` 开头，例如 `+86` | | phoneNumber | String | 二选一 | 手机号，必须包含国家区号，例如 `+8618639254980` | | email |String | 二选一 |邮箱 不区分大小写 | | password | String | 是 | 用户密码 | ![](https://pic1.imgdb.cn/item/6a0d502195d4b7068ae5b326.png) 返回结果：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
    "error": 0,
    "msg": "",
    "data": {
        "user": {
            "timezone": {
                "id": "Asia/Shanghai",
                "offset": 8
            },
            "accountLevel": 20,
            "levelExpiredAt": 1785807949000,
            "countryCode": "+86",
            "phoneNumber": "+8618639254980",
            "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
            "accountConsult": false,
            "appForumEnterHide": true,
            "appVersion": "5.24.0",
            "denyRecharge": false,
            "ipCountry": "CN"
        },
        "at": "29eccddb60bc4e7591f59f7757e717d3dda9694f",
        "rt": "76364e0dee566ff8ddbb345137e13dea8b7592e1",
        "region": "cn"
    }
}

3发送验证码

当 error 为 10004 时，表示账号不在当前区域，客户端需要根据返回的区域信息重新去其它区调用登录接口。

URL：/v2/user/verification-code

认证参数：Sign

请求方法：POST

入参：

名称类型允许为空说明
typeIntN验证码类型：0-注册，1-重置密码，3-注销账号，4-验证码登录
emailStringY发送的邮箱地址，区分大小写
phoneNumberStringY发送的手机号，需包含国家区号，例如 +8618023456789

注意： email 和 phoneNumber 必须二选一填写，至少提供其中一个，否则接口会返回错误。

1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

4查询区域

URL: https://apia.coolkit.cn/v2/utils/get-region

请求方法：GET

认证参数：Sign

名称 类型 允许为空 说明
countryCode String N 电话区号，不需要带 “+” 符号，比如 “86

1
2
3
4
5
6
7
{
    "error": 0,
    "msg": "",
    "data": {
        "region": "cn"
    }
}

5重置密码

URL：/v2/user/reset-pwd

说明：用户如果忘记密码，可以使用该接口重新设置密码

请求方法：POST

认证参数：Sign

名称类型允许为空说明
emailStringY邮箱地址，不区分大小写
phoneNumberStringY手机号，需包含国家区号，例如 +8618023456789
verificationCodeStringN验证码
passwordStringN密码

注意： email 和 phoneNumber 必须二选一填写，至少提供其中一个，否则接口会返回错误。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
    "error": 0,
    "msg": "",
    "data": {
        "user": {
            "timezone": {
                "id": "Asia/Shanghai",
                "offset": 8
            },
            "accountLevel": 20,
            "levelExpiredAt": 1785807949000,
            "countryCode": "+86",
            "phoneNumber": "+8618639254980",
            "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
            "nickname": "newName",
            "accountConsult": false,
            "appForumEnterHide": true,
            "appVersion": "5.24.0",
            "denyRecharge": false,
            "ipCountry": "CN"
        },
        "at": "3cee2bf42fab5a4787ef28ca1183f226104e1999",
        "rt": "d99b36bd20a22f940460bbd170da71d81e0aa1cf",
        "region": "cn"
    }
}

6刷新token

URL：/v2/user/refresh

请求方法：POST

认证参数：accessToken 或者签名

入参

名称类型允许为空说明
rtStringNRefresh Token

1
2
3
4
5
6
7
8
{
    "error": 0,
    "msg": "",
    "data": {
        "at": "76645578ddb8cdc46979fce226c8f39c64727705",
        "rt": "db20db7d00dd17f1ab6836f886813cbb5c8755c2"
    }
}

7更新用户信息

URL：/v2/user/profile

请求方法：POST

认证参数：accessToken

入参：

名称类型允许为空说明
nicknameStringY要更新的用户昵称。如果字段为空或 null，表示不更新昵称。
acceptEmailAdBooleanY是否接受邮件订阅广告。如果字段为空或 null，表示不更新该设置。
accountConsultBooleanY是否接受过会员咨询反馈。固定值必须为 true，填写其他值将返回参数错误。如果字段为空或 null，表示不更新该设置。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

8退出登录

URL：/v2/user/logout

请求方法：DELETE

认证参数：accessToken

请求参数：无

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

9首页

URL：/v2/homepage

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
langStringY用于 APP 推送通知文案语言。cn 表示中文，en 表示英文，默认值为 en。
clientInfoObjectY客户端信息。
getUserObjectY如果需要获取用户信息，则填写此字段。
getFamilyObjectY如果需要获取家庭信息，则填写此字段，返回当前账号下所有家庭的信息。
getThingObjectY如果需要获取 Thing（设备）信息，则填写此字段，仅返回当前家庭下的 Thing 信息。
getSceneObjectY场景列表，暂未开放。
getMessageObjectY如果需要获取消息中心通知信息，则填写此字段，仅返回当前家庭下的通知信息。

10获取家庭和房间

URL：/v2/family

请求方法：GET

认证参数：accessToken

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
{
    "error": 0,
    "msg": "",
    "data": {
        "familyList": [
            {
                "id": "69fdd291e0ee7580ff5b28ea",
                "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                "name": "小怪兽",
                "index": -1,
                "roomList": [
                    {
                        "id": "69fdd291e0ee7580ff5b28eb",
                        "name": "客厅",
                        "index": 0
                    },
                    {
                        "id": "69fdd291e0ee7580ff5b28ec",
                        "name": "卧室",
                        "index": 1
                    },
                    {
                        "id": "69fdd291e0ee7580ff5b28ed",
                        "name": "其他",
                        "index": 2
                    }
                ],
                "familyType": 1,
                "members": []
            },
            {
                "id": "69f80b54ca0633a4a03fa9da",
                "apikey": "8b3525ec-69e3-46f7-beea-9ee520e3483f",
                "name": "175",
                "index": 0,
                "roomList": [
                    {
                        "id": "69f80b54ca0633a4a03fa9db",
                        "name": "客厅",
                        "index": 0
                    },
                    {
                        "id": "69f80b54ca0633a4a03fa9dc",
                        "name": "卧室",
                        "index": 1
                    },
                    {
                        "id": "69f80b54ca0633a4a03fa9dd",
                        "name": "其他",
                        "index": 2
                    }
                ],
                "familyType": 2,
                "members": [
                    {
                        "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                        "phoneNumber": "+8618639254980",
                        "nickname": "newName",
                        "comment": ""
                    }
                ],
                "sharedBy": {
                    "apikey": "8b3525ec-69e3-46f7-beea-9ee520e3483f",
                    "phoneNumber": "+8617589700725"
                }
            }
        ],
        "currentFamilyId": "69fdd291e0ee7580ff5b28ea",
        "hasChangedCurrentFamily": false
    }
}

11新增房间

URL：/v2/family/room

请求方法：POST

认证参数：accessToken

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
    "error": 0,
    "msg": "",
    "data": {
        "id": "6a0d7dcc252cfc3496e493c5",
        "name": "雷",
        "index": -2,
        "roomList": [
            {
                "id": "6a0d7dcc252cfc3496e493c6",
                "name": "房间1",
                "index": 0
            },
            {
                "id": "6a0d7dcc252cfc3496e493c7",
                "name": "房间2",
                "index": 1
            },
            {
                "id": "6a0d7dcc252cfc3496e493c8",
                "name": "其他",
                "index": 2
            }
        ],
        "familyType": 1,
        "members": []
    }
}

12修改家庭名称

URL：/v2/family

请求方法：PUT

认证参数：accessToken

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

13修改房间名称

URL：/v2/family/room

请求方法：PUT

认证参数：accessToken

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

14切换家庭

URL：/v2/family/current

请求方法：POST

认证参数：accessToken

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

15房间排序

URL：/v2/family/room/index

请求方法：POST

认证参数：accessToken


1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

16获取设备列表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
{
    "error": 0,
    "msg": "",
    "data": {
        "thingList": [
            {
                "itemType": 1,
                "itemData": {
                    "name": "SNZB-02D",
                    "deviceid": "a400022591",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "mac": "6f0613feffb425347014",
                        "apmac": "00:00:00:00:00:00",
                        "model": "SN-MG22-THMD-01",
                        "description": "Zigbee带屏温湿度传感器",
                        "modelInfo": "62f2021dd8d0e73cc6f377f0",
                        "manufacturer": "深圳松诺技术有限公司",
                        "brandId": "5c4c1aee3a7d24c7100be054",
                        "uiid": 7014,
                        "ui": "Zigbee带屏温湿度传感器_支持OTA",
                        "reportProduct": "SNZB-02D",
                        "staMac": "0x3425b4fffe13066f"
                    },
                    "brandName": "SONOFF",
                    "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
                    "showBrand": true,
                    "productModel": "SNZB-02D",
                    "tags": {},
                    "devConfig": {},
                    "deviceConfigToApp": {
                        "otaTimeout": 7200
                    },
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -6,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [],
                    "devicekey": "cc0d576b-fe50-4595-b1e8-88081132cad8",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        },
                        "subDevId": "6f0613feffb425347014",
                        "parentid": "1002375d9d",
                        "fwVersion": "2.3.0",
                        "productModel": "SNZB-02D",
                        "battery": 100,
                        "humidity": "5700",
                        "trigTime": "1778810761990",
                        "humiComfortStatus": 2,
                        "temperature": "2580",
                        "tempComfortStatus": 2,
                        "otaInfo": {
                            "state": 0,
                            "reason": 12,
                            "stateTime": 1778811965157
                        },
                        "tempCorrection": "0.0",
                        "tempUnit": 0,
                        "humCorrection": "0.0",
                        "humiComfortLower": "4000",
                        "humiComfortUpper": "6000",
                        "tempComfortLower": "1900",
                        "tempComfortUpper": "2700",
                        "timeZone": 8,
                        "subDevRssi": -44
                    },
                    "denyFeatures": [
                        "clickToWakeDevice",
                        "doubleClickWakeDevice",
                        "temperature_control_precision"
                    ],
                    "isSupportGroup": false,
                    "isSupportedOnMP": false,
                    "isSupportChannelSplit": false,
                    "wxModelId": "1EZqRP5bC0_CKqAAsme5UA",
                    "deviceFeature": {}
                },
                "index": -6
            },
            {
                "itemType": 1,
                "itemData": {
                    "name": "NSPanel86PB",
                    "deviceid": "1002375d9d",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "model": "SN-RKPX30-NSP-01",
                        "mac": "d0:27:03:e5:7b:0c",
                        "apmac": "d0:27:03:e5:7b:0d",
                        "uiid": 195,
                        "ui": "NSPanel Pro",
                        "modelInfo": "62284181e9996d416dcc77bc",
                        "brandId": "5c4c1aee3a7d24c7100be054",
                        "itCredential": "Va1K7yihCsIn5yne",
                        "description": "",
                        "manufacturer": "深圳松诺技术有限公司"
                    },
                    "brandName": "SONOFF",
                    "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
                    "showBrand": true,
                    "productModel": "NSPanel86PB",
                    "tags": {
                        "m_ee8c_4980": "on"
                    },
                    "devConfig": {},
                    "deviceConfigToApp": {
                        "forum": "https://forum.ewelink.cc/t/rolling-with-new-releases-nspanel-pro-firmware-updates/207466"
                    },
                    "settings": {
                        "opsNotify": 1,
                        "opsHistory": 1,
                        "alarmNotify": 1
                    },
                    "devGroups": [],
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -3,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [],
                    "devicekey": "80afff29-a914-4468-9a14-3c57e0523b56",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        },
                        "rooted": false,
                        "version": 7,
                        "appVersion": "4.4.0",
                        "fwVersion": "4.4.0",
                        "sysVersion": "4.4.0",
                        "zigbeeVersion": "1.0.0",
                        "supportFeature": {
                            "isSupportRemoveMQTTInfo": true,
                            "isSupportEnableAccessibilityButton": true,
                            "isSupportHAToMatter": true,
                            "isSupportSyncToHA": true,
                            "isSupportSwitchZigbeeRoleSeamless": true,
                            "isSupportVideoSegment": true
                        },
                        "supportMatterDeviceType": [
                            "14",
                            "266",
                            "259",
                            "269",
                            "268",
                            "257",
                            "256",
                            "770",
                            "21",
                            "775",
                            "263",
                            "262",
                            "15"
                        ],
                        "gatewayBindRelations": [],
                        "relatedDevices": [],
                        "fabricList": [],
                        "isSupportMatterBridge": true,
                        "supportMatterSubDevices": [
                            "a400022591"
                        ],
                        "supportUIIDToMatter": [
                            "1",
                            "2",
                            "3",
                            "4",
                            "5",
                            "6",
                            "7",
                            "8",
                            "9",
                            "11",
                            "14",
                            "15",
                            "32",
                            "34",
                            "36",
                            "44",
                            "59",
                            "77",
                            "103",
                            "104",
                            "126",
                            "133",
                            "135",
                            "136",
                            "137",
                            "138",
                            "139",
                            "140",
                            "141",
                            "154",
                            "160",
                            "161",
                            "162",
                            "165",
                            "173",
                            "181",
                            "182",
                            "190",
                            "191",
                            "209",
                            "210",
                            "211",
                            "212"
                        ],
                        "screenSortList": {
                            "screenList1": [
                                "a400022591",
                                "100258c6ed"
                            ]
                        },
                        "screenList1": [
                            "a400022591"
                        ],
                        "screenList2": [],
                        "screenList3": [],
                        "cameraList": [],
                        "showablePannels": [
                            "main",
                            "thingList",
                            "sceneList"
                        ],
                        "securityType": 0,
                        "multiChannelDevices": {},
                        "turboMode": false,
                        "addDevTime": 180,
                        "addSubDevState": "off",
                        "subDevices": [
                            {
                                "subDevId": "6f0613feffb425347014",
                                "deviceid": "a400022591",
                                "online": true,
                                "uiid": "7014",
                                "index": 140689
                            }
                        ],
                        "syncSubDeviceToHA": [],
                        "cpuInfo": {
                            "temperature": 47.272
                        },
                        "cityId": "WA@23.391,113.746",
                        "dst": 0,
                        "tempRange": "23.5,30.2",
                        "temperature": 27.2,
                        "timeZone": 8,
                        "timeZoneId": "Asia/Shanghai",
                        "weather": 18,
                        "airQuality": {
                            "co": 396.85,
                            "no2": 32.25,
                            "o3": 89,
                            "so2": 35.45,
                            "pm2_5": 41.75,
                            "pm10": 42.55,
                            "us-epa-index": 3,
                            "gb-defra-index": 4
                        },
                        "dstChange": null,
                        "storageInfo": {
                            "total": "3.36 GB",
                            "free": "2.54 GB",
                            "used": "834.82 MB",
                            "/": "3.26 MB",
                            "/dev": "488 KB",
                            "/system": "1.42 GB",
                            "/vendor": "348.16 MB",
                            "/mnt": "0 B",
                            "/oem": "46.83 MB",
                            "/cache": "12.89 MB",
                            "/metadata": "576 KB",
                            "/data": "886.41 MB",
                            "/storage": "0 B",
                            "/storage/emulated": "886.41 MB",
                            "/storage/self": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage": "12 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-shm": "32 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-wal": "410.42 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage-journal": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database": "172 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases": "626.42 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/matter-bridge-app.zlog.conf": "156 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/profileinstaller_profileWrittenFor_lastUpdateTime.dat": "8 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/zigbee/zigbee-model-mapping.json": "2.2 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/androidx.appcompat.app.AppCompatDelegate.application_locales_record_file": "95 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-14.bak.1": "20 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-14": "16.56 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/matter-bridge-app.log": "367.49 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-13": "14.29 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files": "51.21 MB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.KeyValueStore.xml": "296 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.ConfigurationManager.xml": "153 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.repository.xml": "79.93 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.preferences.xml": "183 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.ConfigurationManager.xml": "153 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/plain_config.xml": "10.91 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.KeyValueStore.xml": "1.59 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip_tool_config.device.ini": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs": "93.19 KB",
                            "/storage/emulated/0/Android/data/.nomedia": "0 B",
                            "/storage/emulated/0": "0 B"
                        },
                        "PREVTZ": 1,
                        "TZ": "Asia/Shanghai",
                        "matterPairTs": 1778678966136,
                        "matterPair": {
                            "state": "off",
                            "duration": 0
                        },
                        "isSupportSyncToHA": true,
                        "zigbeeNetworkRole": "Coordinator",
                        "otaState": "idle"
                    },
                    "denyFeatures": [
                        "webShortcut",
                        "value_open_ratio",
                        "gatewayReboot",
                        "zigbeeChangeChannel",
                        "autoCompensationForNoOne"
                    ],
                    "isSupportGroup": false,
                    "isSupportedOnMP": false,
                    "isSupportChannelSplit": false,
                    "deviceFeature": {},
                    "matterInfoData": {
                        "matterFabricId": "019DD74CA3D28799",
                        "matterNodeId": "0000000000000008"
                    }
                },
                "index": -3
            }
        ],
        "total": 2
    }
}

17获取Thing列表

URL：/v2/device/thing

请求方法：GET

认证参数：accessToken

名称类型允许为空说明
langStringY用于 APP 推送通知文案语言。cn 表示中文，en 表示英文，默认值为 en。
familyidStringY家庭 ID，不填写时默认使用当前家庭。
numIntY获取的数据数量，默认值为 30，填写 0 表示获取全部数据。
beginIndexIntY从指定序号开始获取列表数据，不填写时默认值为 -9999999。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
{
    "error": 0,
    "msg": "",
    "data": {
        "thingList": [
            {
                "itemType": 1,
                "itemData": {
                    "name": "SNZB-02D",
                    "deviceid": "a400022591",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "mac": "6f0613feffb425347014",
                        "apmac": "00:00:00:00:00:00",
                        "model": "SN-MG22-THMD-01",
                        "description": "Zigbee带屏温湿度传感器",
                        "modelInfo": "62f2021dd8d0e73cc6f377f0",
                        "manufacturer": "深圳松诺技术有限公司",
                        "brandId": "5c4c1aee3a7d24c7100be054",
                        "uiid": 7014,
                        "ui": "Zigbee带屏温湿度传感器_支持OTA",
                        "reportProduct": "SNZB-02D",
                        "staMac": "0x3425b4fffe13066f"
                    },
                    "brandName": "SONOFF",
                    "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
                    "showBrand": true,
                    "productModel": "SNZB-02D",
                    "tags": {},
                    "devConfig": {},
                    "deviceConfigToApp": {
                        "otaTimeout": 7200
                    },
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -6,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [],
                    "devicekey": "cc0d576b-fe50-4595-b1e8-88081132cad8",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        },
                        "subDevId": "6f0613feffb425347014",
                        "parentid": "1002375d9d",
                        "fwVersion": "2.3.0",
                        "productModel": "SNZB-02D",
                        "battery": 100,
                        "humidity": "5700",
                        "trigTime": "1778810761990",
                        "humiComfortStatus": 2,
                        "temperature": "2580",
                        "tempComfortStatus": 2,
                        "otaInfo": {
                            "state": 0,
                            "reason": 12,
                            "stateTime": 1778811965157
                        },
                        "tempCorrection": "0.0",
                        "tempUnit": 0,
                        "humCorrection": "0.0",
                        "humiComfortLower": "4000",
                        "humiComfortUpper": "6000",
                        "tempComfortLower": "1900",
                        "tempComfortUpper": "2700",
                        "timeZone": 8,
                        "subDevRssi": -44
                    },
                    "denyFeatures": [
                        "clickToWakeDevice",
                        "doubleClickWakeDevice",
                        "temperature_control_precision"
                    ],
                    "isSupportGroup": false,
                    "isSupportedOnMP": false,
                    "isSupportChannelSplit": false,
                    "wxModelId": "1EZqRP5bC0_CKqAAsme5UA",
                    "deviceFeature": {}
                },
                "index": -6
            },
            {
                "itemType": 1,
                "itemData": {
                    "name": "NSPanel86PB",
                    "deviceid": "1002375d9d",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "model": "SN-RKPX30-NSP-01",
                        "mac": "d0:27:03:e5:7b:0c",
                        "apmac": "d0:27:03:e5:7b:0d",
                        "uiid": 195,
                        "ui": "NSPanel Pro",
                        "modelInfo": "62284181e9996d416dcc77bc",
                        "brandId": "5c4c1aee3a7d24c7100be054",
                        "itCredential": "Va1K7yihCsIn5yne",
                        "description": "",
                        "manufacturer": "深圳松诺技术有限公司"
                    },
                    "brandName": "SONOFF",
                    "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
                    "showBrand": true,
                    "productModel": "NSPanel86PB",
                    "tags": {
                        "m_ee8c_4980": "on"
                    },
                    "devConfig": {},
                    "deviceConfigToApp": {
                        "forum": "https://forum.ewelink.cc/t/rolling-with-new-releases-nspanel-pro-firmware-updates/207466"
                    },
                    "settings": {
                        "opsNotify": 1,
                        "opsHistory": 1,
                        "alarmNotify": 1
                    },
                    "devGroups": [],
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -3,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [],
                    "devicekey": "80afff29-a914-4468-9a14-3c57e0523b56",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        },
                        "rooted": false,
                        "version": 7,
                        "appVersion": "4.4.0",
                        "fwVersion": "4.4.0",
                        "sysVersion": "4.4.0",
                        "zigbeeVersion": "1.0.0",
                        "supportFeature": {
                            "isSupportRemoveMQTTInfo": true,
                            "isSupportEnableAccessibilityButton": true,
                            "isSupportHAToMatter": true,
                            "isSupportSyncToHA": true,
                            "isSupportSwitchZigbeeRoleSeamless": true,
                            "isSupportVideoSegment": true
                        },
                        "supportMatterDeviceType": [
                            "14",
                            "266",
                            "259",
                            "269",
                            "268",
                            "257",
                            "256",
                            "770",
                            "21",
                            "775",
                            "263",
                            "262",
                            "15"
                        ],
                        "gatewayBindRelations": [],
                        "relatedDevices": [],
                        "fabricList": [],
                        "isSupportMatterBridge": true,
                        "supportMatterSubDevices": [
                            "a400022591"
                        ],
                        "supportUIIDToMatter": [
                            "1",
                            "2",
                            "3",
                            "4",
                            "5",
                            "6",
                            "7",
                            "8",
                            "9",
                            "11",
                            "14",
                            "15",
                            "32",
                            "34",
                            "36",
                            "44",
                            "59",
                            "77",
                            "103",
                            "104",
                            "126",
                            "133",
                            "135",
                            "136",
                            "137",
                            "138",
                            "139",
                            "140",
                            "141",
                            "154",
                            "160",
                            "161",
                            "162",
                            "165",
                            "173",
                            "181",
                            "182",
                            "190",
                            "191",
                            "209",
                            "210",
                            "211",
                            "212"
                        ],
                        "screenSortList": {
                            "screenList1": [
                                "a400022591",
                                "100258c6ed"
                            ]
                        },
                        "screenList1": [
                            "a400022591"
                        ],
                        "screenList2": [],
                        "screenList3": [],
                        "cameraList": [],
                        "showablePannels": [
                            "main",
                            "thingList",
                            "sceneList"
                        ],
                        "securityType": 0,
                        "multiChannelDevices": {},
                        "turboMode": false,
                        "addDevTime": 180,
                        "addSubDevState": "off",
                        "subDevices": [
                            {
                                "subDevId": "6f0613feffb425347014",
                                "deviceid": "a400022591",
                                "online": true,
                                "uiid": "7014",
                                "index": 140689
                            }
                        ],
                        "syncSubDeviceToHA": [],
                        "cpuInfo": {
                            "temperature": 47.272
                        },
                        "cityId": "WA@23.391,113.746",
                        "dst": 0,
                        "tempRange": "23.5,30.2",
                        "temperature": 27.2,
                        "timeZone": 8,
                        "timeZoneId": "Asia/Shanghai",
                        "weather": 18,
                        "airQuality": {
                            "co": 396.85,
                            "no2": 32.25,
                            "o3": 89,
                            "so2": 35.45,
                            "pm2_5": 41.75,
                            "pm10": 42.55,
                            "us-epa-index": 3,
                            "gb-defra-index": 4
                        },
                        "dstChange": null,
                        "storageInfo": {
                            "total": "3.36 GB",
                            "free": "2.54 GB",
                            "used": "834.82 MB",
                            "/": "3.26 MB",
                            "/dev": "488 KB",
                            "/system": "1.42 GB",
                            "/vendor": "348.16 MB",
                            "/mnt": "0 B",
                            "/oem": "46.83 MB",
                            "/cache": "12.89 MB",
                            "/metadata": "576 KB",
                            "/data": "886.41 MB",
                            "/storage": "0 B",
                            "/storage/emulated": "886.41 MB",
                            "/storage/self": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage": "12 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-shm": "32 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-wal": "410.42 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage-journal": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database": "172 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases": "626.42 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/matter-bridge-app.zlog.conf": "156 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/profileinstaller_profileWrittenFor_lastUpdateTime.dat": "8 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/zigbee/zigbee-model-mapping.json": "2.2 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/androidx.appcompat.app.AppCompatDelegate.application_locales_record_file": "95 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-14.bak.1": "20 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-14": "16.56 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/matter-bridge-app.log": "367.49 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-13": "14.29 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files": "51.21 MB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.KeyValueStore.xml": "296 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.ConfigurationManager.xml": "153 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.repository.xml": "79.93 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.preferences.xml": "183 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.ConfigurationManager.xml": "153 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/plain_config.xml": "10.91 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.KeyValueStore.xml": "1.59 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip_tool_config.device.ini": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs": "93.19 KB",
                            "/storage/emulated/0/Android/data/.nomedia": "0 B",
                            "/storage/emulated/0": "0 B"
                        },
                        "PREVTZ": 1,
                        "TZ": "Asia/Shanghai",
                        "matterPairTs": 1778678966136,
                        "matterPair": {
                            "state": "off",
                            "duration": 0
                        },
                        "isSupportSyncToHA": true,
                        "zigbeeNetworkRole": "Coordinator",
                        "otaState": "idle"
                    },
                    "denyFeatures": [
                        "webShortcut",
                        "value_open_ratio",
                        "gatewayReboot",
                        "zigbeeChangeChannel",
                        "autoCompensationForNoOne"
                    ],
                    "isSupportGroup": false,
                    "isSupportedOnMP": false,
                    "isSupportChannelSplit": false,
                    "deviceFeature": {},
                    "matterInfoData": {
                        "matterFabricId": "019DD74CA3D28799",
                        "matterNodeId": "0000000000000008"
                    }
                },
                "index": -3
            }
        ],
        "total": 2
    }
}

18获取指定 Thing 列表信息

URL：/v2/device/thing

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
thingListArrayN需要获取的 Thing 列表。数组长度必须大于 0 且小于等于 10。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
{
    "error": 0,
    "msg": "",
    "data": {
        "thingList": [
            {
                "itemType": 1,
                "itemData": {
                    "name": "NSPanel86PB",
                    "deviceid": "1002375d9d",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "model": "SN-RKPX30-NSP-01",
                        "mac": "d0:27:03:e5:7b:0c",
                        "apmac": "d0:27:03:e5:7b:0d",
                        "uiid": 195,
                        "ui": "NSPanel Pro",
                        "modelInfo": "62284181e9996d416dcc77bc",
                        "brandId": "5c4c1aee3a7d24c7100be054",
                        "itCredential": "Va1K7yihCsIn5yne",
                        "description": "",
                        "manufacturer": "深圳松诺技术有限公司"
                    },
                    "brandName": "SONOFF",
                    "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
                    "showBrand": true,
                    "productModel": "NSPanel86PB",
                    "tags": {
                        "m_ee8c_4980": "on"
                    },
                    "devConfig": {},
                    "deviceConfigToApp": {
                        "forum": "https://forum.ewelink.cc/t/rolling-with-new-releases-nspanel-pro-firmware-updates/207466"
                    },
                    "settings": {
                        "opsNotify": 1,
                        "opsHistory": 1,
                        "alarmNotify": 1
                    },
                    "devGroups": [],
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -3,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [],
                    "devicekey": "80afff29-a914-4468-9a14-3c57e0523b56",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        },
                        "rooted": false,
                        "version": 7,
                        "appVersion": "4.4.0",
                        "fwVersion": "4.4.0",
                        "sysVersion": "4.4.0",
                        "zigbeeVersion": "1.0.0",
                        "supportFeature": {
                            "isSupportRemoveMQTTInfo": true,
                            "isSupportEnableAccessibilityButton": true,
                            "isSupportHAToMatter": true,
                            "isSupportSyncToHA": true,
                            "isSupportSwitchZigbeeRoleSeamless": true,
                            "isSupportVideoSegment": true
                        },
                        "supportMatterDeviceType": [
                            "14",
                            "266",
                            "259",
                            "269",
                            "268",
                            "257",
                            "256",
                            "770",
                            "21",
                            "775",
                            "263",
                            "262",
                            "15"
                        ],
                        "gatewayBindRelations": [],
                        "relatedDevices": [],
                        "fabricList": [],
                        "isSupportMatterBridge": true,
                        "supportMatterSubDevices": [
                            "a400022591"
                        ],
                        "supportUIIDToMatter": [
                            "1",
                            "2",
                            "3",
                            "4",
                            "5",
                            "6",
                            "7",
                            "8",
                            "9",
                            "11",
                            "14",
                            "15",
                            "32",
                            "34",
                            "36",
                            "44",
                            "59",
                            "77",
                            "103",
                            "104",
                            "126",
                            "133",
                            "135",
                            "136",
                            "137",
                            "138",
                            "139",
                            "140",
                            "141",
                            "154",
                            "160",
                            "161",
                            "162",
                            "165",
                            "173",
                            "181",
                            "182",
                            "190",
                            "191",
                            "209",
                            "210",
                            "211",
                            "212"
                        ],
                        "screenSortList": {
                            "screenList1": [
                                "a400022591",
                                "100258c6ed"
                            ]
                        },
                        "screenList1": [
                            "a400022591"
                        ],
                        "screenList2": [],
                        "screenList3": [],
                        "cameraList": [],
                        "showablePannels": [
                            "main",
                            "thingList",
                            "sceneList"
                        ],
                        "securityType": 0,
                        "multiChannelDevices": {},
                        "turboMode": false,
                        "addDevTime": 180,
                        "addSubDevState": "off",
                        "subDevices": [],
                        "syncSubDeviceToHA": [],
                        "cpuInfo": {
                            "temperature": 47.272
                        },
                        "cityId": "WA@23.391,113.746",
                        "dst": 0,
                        "tempRange": "22.2,26.4",
                        "temperature": 23.7,
                        "timeZone": 8,
                        "timeZoneId": "Asia/Shanghai",
                        "weather": 11,
                        "airQuality": {
                            "co": 222.85,
                            "no2": 22.55,
                            "o3": 50,
                            "so2": 18.85,
                            "pm2_5": 10.75,
                            "pm10": 12.05,
                            "us-epa-index": 1,
                            "gb-defra-index": 1
                        },
                        "dstChange": null,
                        "storageInfo": {
                            "total": "3.36 GB",
                            "free": "2.7 GB",
                            "used": "670.08 MB",
                            "/": "3.26 MB",
                            "/dev": "488 KB",
                            "/system": "1.42 GB",
                            "/vendor": "348.16 MB",
                            "/mnt": "0 B",
                            "/oem": "46.83 MB",
                            "/cache": "12.89 MB",
                            "/metadata": "576 KB",
                            "/data": "721.67 MB",
                            "/storage": "0 B",
                            "/storage/emulated": "721.67 MB",
                            "/storage/self": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage": "12 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-shm": "32 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-wal": "410.42 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage-journal": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database": "172 KB",
                            "/data/user/0/com.eWeLinkControlPanel/databases": "626.42 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/matter-bridge-app.zlog.conf": "156 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/profileinstaller_profileWrittenFor_lastUpdateTime.dat": "8 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/zigbee/zigbee-model-mapping.json": "2.2 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/androidx.appcompat.app.AppCompatDelegate.application_locales_record_file": "95 B",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-14": "2.96 MB",
                            "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-20": "16.97 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files/crash/tombstone_00001778807837744742_4.4.0__com.eWeLinkControlPanel.anr.xcrash": "189.11 KB",
                            "/data/user/0/com.eWeLinkControlPanel/files": "3.16 MB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.KeyValueStore.xml": "296 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.ConfigurationManager.xml": "153 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.repository.xml": "79.93 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.preferences.xml": "183 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.ConfigurationManager.xml": "153 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/plain_config.xml": "11.15 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.KeyValueStore.xml": "1.59 KB",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip_tool_config.device.ini": "0 B",
                            "/data/user/0/com.eWeLinkControlPanel/shared_prefs": "93.44 KB",
                            "/storage/emulated/0/Android/data/.nomedia": "0 B",
                            "/storage/emulated/0": "0 B"
                        },
                        "PREVTZ": 1,
                        "TZ": "Asia/Shanghai",
                        "matterPairTs": 1778678966136,
                        "matterPair": {
                            "state": "off",
                            "duration": 0
                        },
                        "isSupportSyncToHA": true,
                        "zigbeeNetworkRole": "Coordinator",
                        "otaState": "idle"
                    },
                    "denyFeatures": [
                        "webShortcut",
                        "value_open_ratio",
                        "gatewayReboot",
                        "zigbeeChangeChannel",
                        "autoCompensationForNoOne"
                    ],
                    "isSupportGroup": false,
                    "isSupportedOnMP": false,
                    "isSupportChannelSplit": false,
                    "deviceFeature": {},
                    "matterInfoData": {
                        "matterFabricId": "019DD74CA3D28799",
                        "matterNodeId": "0000000000000008"
                    }
                },
                "index": -3
            }
        ]
    }
}

19获取设备或群组的状态

URL：/v2/device/thing/status

请求方法：GET

认证参数：accessToken

名称类型允许为空说明
typeIntN指定获取对象类型：1 表示设备，2 表示群组。
idStringN对象 ID。当 type = 1 时填写设备的 deviceid；当 type = 2 时填写群组 ID。
paramsStringY需要获取的状态参数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
{
    "error": 0,
    "msg": "",
    "data": {
        "params": {
            "bindInfos": {
                "alexa": []
            },
            "rooted": false,
            "version": 7,
            "appVersion": "4.4.0",
            "fwVersion": "4.4.0",
            "sysVersion": "4.4.0",
            "zigbeeVersion": "1.0.0",
            "supportFeature": {
                "isSupportRemoveMQTTInfo": true,
                "isSupportEnableAccessibilityButton": true,
                "isSupportHAToMatter": true,
                "isSupportSyncToHA": true,
                "isSupportSwitchZigbeeRoleSeamless": true,
                "isSupportVideoSegment": true
            },
            "supportMatterDeviceType": [
                "14",
                "266",
                "259",
                "269",
                "268",
                "257",
                "256",
                "770",
                "21",
                "775",
                "263",
                "262",
                "15"
            ],
            "gatewayBindRelations": [],
            "relatedDevices": [],
            "fabricList": [],
            "isSupportMatterBridge": true,
            "supportMatterSubDevices": [
                "a400022591"
            ],
            "supportUIIDToMatter": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "11",
                "14",
                "15",
                "32",
                "34",
                "36",
                "44",
                "59",
                "77",
                "103",
                "104",
                "126",
                "133",
                "135",
                "136",
                "137",
                "138",
                "139",
                "140",
                "141",
                "154",
                "160",
                "161",
                "162",
                "165",
                "173",
                "181",
                "182",
                "190",
                "191",
                "209",
                "210",
                "211",
                "212"
            ],
            "screenSortList": {
                "screenList1": [
                    "a400022591",
                    "100258c6ed"
                ]
            },
            "screenList1": [
                "a400022591"
            ],
            "screenList2": [],
            "screenList3": [],
            "cameraList": [],
            "showablePannels": [
                "main",
                "thingList",
                "sceneList"
            ],
            "securityType": 0,
            "multiChannelDevices": {},
            "turboMode": false,
            "addDevTime": 180,
            "addSubDevState": "off",
            "subDevices": [],
            "syncSubDeviceToHA": [],
            "cpuInfo": {
                "temperature": 47.272
            },
            "cityId": "WA@23.391,113.746",
            "dst": 0,
            "tempRange": "22.2,26.4",
            "temperature": 23.7,
            "timeZone": 8,
            "timeZoneId": "Asia/Shanghai",
            "weather": 11,
            "airQuality": {
                "co": 222.85,
                "no2": 22.55,
                "o3": 50,
                "so2": 18.85,
                "pm2_5": 10.75,
                "pm10": 12.05,
                "us-epa-index": 1,
                "gb-defra-index": 1
            },
            "dstChange": null,
            "storageInfo": {
                "total": "3.36 GB",
                "free": "2.7 GB",
                "used": "670.08 MB",
                "/": "3.26 MB",
                "/dev": "488 KB",
                "/system": "1.42 GB",
                "/vendor": "348.16 MB",
                "/mnt": "0 B",
                "/oem": "46.83 MB",
                "/cache": "12.89 MB",
                "/metadata": "576 KB",
                "/data": "721.67 MB",
                "/storage": "0 B",
                "/storage/emulated": "721.67 MB",
                "/storage/self": "0 B",
                "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage": "12 KB",
                "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-shm": "32 KB",
                "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database-wal": "410.42 KB",
                "/data/user/0/com.eWeLinkControlPanel/databases/RKStorage-journal": "0 B",
                "/data/user/0/com.eWeLinkControlPanel/databases/nspanelpro_database": "172 KB",
                "/data/user/0/com.eWeLinkControlPanel/databases": "626.42 KB",
                "/data/user/0/com.eWeLinkControlPanel/files/matter-bridge-app.zlog.conf": "156 B",
                "/data/user/0/com.eWeLinkControlPanel/files/profileinstaller_profileWrittenFor_lastUpdateTime.dat": "8 B",
                "/data/user/0/com.eWeLinkControlPanel/files/zigbee/zigbee-model-mapping.json": "2.2 KB",
                "/data/user/0/com.eWeLinkControlPanel/files/androidx.appcompat.app.AppCompatDelegate.application_locales_record_file": "95 B",
                "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-14": "2.96 MB",
                "/data/user/0/com.eWeLinkControlPanel/files/logs/2026-05-20": "16.97 KB",
                "/data/user/0/com.eWeLinkControlPanel/files/crash/tombstone_00001778807837744742_4.4.0__com.eWeLinkControlPanel.anr.xcrash": "189.11 KB",
                "/data/user/0/com.eWeLinkControlPanel/files": "3.16 MB",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.KeyValueStore.xml": "296 B",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.matterbridge.ConfigurationManager.xml": "153 B",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.repository.xml": "79.93 KB",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/com.crowdin.platform.string.preferences.xml": "183 B",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.ConfigurationManager.xml": "153 B",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/plain_config.xml": "11.15 KB",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip.platform.KeyValueStore.xml": "1.59 KB",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs/chip_tool_config.device.ini": "0 B",
                "/data/user/0/com.eWeLinkControlPanel/shared_prefs": "93.44 KB",
                "/storage/emulated/0/Android/data/.nomedia": "0 B",
                "/storage/emulated/0": "0 B"
            },
            "PREVTZ": 1,
            "TZ": "Asia/Shanghai",
            "matterPairTs": 1778678966136,
            "matterPair": {
                "state": "off",
                "duration": 0
            },
            "isSupportSyncToHA": true,
            "zigbeeNetworkRole": "Coordinator",
            "otaState": "idle"
        }
    }
}

20更新设备或群组的状态

URL：/v2/device/thing/status

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
typeIntN指定更新对象类型：1 表示设备，2 表示群组。
idStringN对象 ID。当 type = 1 时填写设备的 deviceid；当 type = 2 时填写群组 ID。
paramsObjectN需要更新的状态参数对象。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

21 添加wifi设备

URL：/v2/device/add

请求方法：POST

认证参数：accessToken

参数名类型是否必填说明
nameString是设备名称
deviceidString是设备 ID
settingsObject否用户设置，未传则使用默认值
ifrCodeString否红外设备码值
digestString是SHA256(deviceid + 设备apikey) 的小写字符串
chipidString是设备芯片 ID
familyidString否设备所属家庭 ID，为空则添加到当前家庭
roomidString否设备所属房间 ID，为空则放入【未分配】
sortInt否新设备序号分配方式，默认 1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
{
    "error": 0,
    "msg": "",
    "data": {
        "itemType": 1,
        "itemData": {
            "name": "ZBBridge-P",
            "deviceid": "100273b78a",
            "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
            "extra": {
                "model": "SN-NG-ZBP-01",
                "mac": "d0:27:04:5e:2e:e6",
                "apmac": "d0:27:04:5e:2e:e7",
                "uiid": 168,
                "ui": "ZigBee蜂鸣网关",
                "modelInfo": "612c78ef2089bfdd1ba00acb",
                "brandId": "5c4c1aee3a7d24c7100be054",
                "itCredential": "5EMvbUhJnhpJQlzW",
                "description": "",
                "manufacturer": "深圳松诺技术有限公司",
                "staMac": "80F3DA5B2A0C"
            },
            "brandName": "SONOFF",
            "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
            "showBrand": true,
            "productModel": "ZBBridge-P",
            "tags": {
                "key": "value"
            },
            "devConfig": {},
            "settings": {
                "opsNotify": 0,
                "opsHistory": 1,
                "alarmNotify": 1,
                "wxAlarmNotify": 0,
                "wxOpsNotify": 0,
                "wxDoorbellNotify": 0,
                "appDoorbellNotify": 1
            },
            "devGroups": [],
            "family": {
                "familyid": "69fdd291e0ee7580ff5b28ea",
                "index": 0,
                "members": [],
                "guests": []
            },
            "shareTo": [],
            "devicekey": "4c9a4f02-f46c-4445-bba5-4b430cf9e950",
            "online": true,
            "params": {
                "bindInfos": {
                    "alexa": []
                },
                "version": 8,
                "bssid": "44:F7:70:FA:A1:EA",
                "buzzerAlarm": {
                    "mode": "stop"
                },
                "coordinatorVersion": "2.7.20",
                "currentChannel": 20,
                "fwVersion": "3.1.4",
                "hostVersion": "3.1.4",
                "rssi": -55,
                "sledOnline": "on",
                "ssid": "taotao_2.4G",
                "staMac": "80F3DA5B2A0C",
                "subDevMaxNum": 128,
                "zled": "on",
                "directDevNum": 1,
                "routerDevNum": 1,
                "timeZone": 8,
                "TZ": "Asia/Shanghai",
                "resetCode": 3,
                "subDevices": [],
                "gatewayBindRelations": [],
                "panID": 31230,
                "nvPanID": 31230
            },
            "denyFeatures": [
                "newVersionSubDeviceOta",
                "newVersionSubDeviceOtaV2",
                "newVersionSubDeviceOtaV3",
                "matterFabricSetting",
                "autoCompensationForNoOne"
            ],
            "isSupportGroup": false,
            "isSupportedOnMP": false,
            "isSupportChannelSplit": false,
            "deviceFeature": {
                "scenes": []
            }
        },
        "index": 0
    }
}

22添加GSM设备

URL：/v2/device/add-gsm

请求方法：POST

认证参数：accessToken

参数名类型必填说明
idString是从扫描设备二维码 URL 中获取设备 gsmId。例如：https://api.coolkit.cc:8080/api/user/device/addGsm?id=348512d49379bb0acace4598e14fc450，其中 id 参数值即为设备 gsmId
nameString是设备名称
familyidString否设备所属家庭 ID，为空时表示添加到当前家庭
roomidString否设备所属房间 ID，为空时表示添加到“未分配”房间
sortInt否新设备分配序号方式，默认值为 1。1 表示分配更小序号，2 表示分配更大序号

23 更新设备的名称/房间信息

URL：/v2/device/update-info

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
deviceidStringN设备 ID。
nameStringY设备名称。
roomidStringY房间 ID。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

24 删除设备

URL：/v2/device

请求方法：DELETE

认证参数：accessToken

名称类型允许为空说明
deviceidStringN要删除的设备 ID。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

25 修改设备标签

URL：/v2/device/tags

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
deviceidStringN设备 ID。
typeStringY修改类型，不填写时默认值为 replace。replace 表示覆盖，merge 表示合并。
tagsObjectN设备标签对象。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
{
    "error": 0,
    "msg": "",
    "data": {
        "updatedThing": {
            "itemType": 1,
            "itemData": {
                "name": "ZBBridge-P",
                "deviceid": "100273b78a",
                "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                "extra": {
                    "model": "SN-NG-ZBP-01",
                    "mac": "d0:27:04:5e:2e:e6",
                    "apmac": "d0:27:04:5e:2e:e7",
                    "uiid": 168,
                    "ui": "ZigBee蜂鸣网关",
                    "modelInfo": "612c78ef2089bfdd1ba00acb",
                    "brandId": "5c4c1aee3a7d24c7100be054",
                    "itCredential": "5EMvbUhJnhpJQlzW",
                    "description": "",
                    "manufacturer": "深圳松诺技术有限公司",
                    "staMac": "80F3DA5B2A0C"
                },
                "brandName": "SONOFF",
                "brandLogo": "https://cn-ota.coolkit.cc/logo/q62PevoglDNmwUJ9oPE7kRrpt1nL1CoA.png",
                "showBrand": true,
                "productModel": "ZBBridge-P",
                "tags": {
                    "key": "value"
                },
                "devConfig": {},
                "settings": {
                    "opsNotify": 0,
                    "opsHistory": 1,
                    "alarmNotify": 1,
                    "wxAlarmNotify": 0,
                    "wxOpsNotify": 0,
                    "wxDoorbellNotify": 0,
                    "appDoorbellNotify": 1
                },
                "devGroups": [],
                "family": {
                    "familyid": "69fdd291e0ee7580ff5b28ea",
                    "index": 0,
                    "members": [],
                    "guests": []
                },
                "shareTo": [],
                "devicekey": "4c9a4f02-f46c-4445-bba5-4b430cf9e950",
                "online": true,
                "params": {
                    "bindInfos": {
                        "alexa": []
                    },
                    "version": 8,
                    "bssid": "44:F7:70:FA:A1:EA",
                    "buzzerAlarm": {
                        "mode": "stop"
                    },
                    "coordinatorVersion": "2.7.20",
                    "currentChannel": 20,
                    "fwVersion": "3.1.4",
                    "hostVersion": "3.1.4",
                    "rssi": -63,
                    "sledOnline": "on",
                    "ssid": "taotao_2.4G",
                    "staMac": "80F3DA5B2A0C",
                    "subDevMaxNum": 128,
                    "zled": "on",
                    "directDevNum": 2,
                    "routerDevNum": 0,
                    "timeZone": 8,
                    "TZ": "Asia/Shanghai",
                    "resetCode": 3,
                    "subDevices": [],
                    "gatewayBindRelations": []
                },
                "denyFeatures": [
                    "newVersionSubDeviceOta",
                    "newVersionSubDeviceOtaV2",
                    "newVersionSubDeviceOtaV3",
                    "matterFabricSetting",
                    "autoCompensationForNoOne"
                ],
                "isSupportGroup": false,
                "isSupportedOnMP": false,
                "isSupportChannelSplit": false,
                "deviceFeature": {
                    "scenes": []
                }
            },
            "index": 0
        }
    }
}

26 新增设备群组

URL：/v2/device/group

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
nameStringN群组名称，最大长度为 50 个字符。
mainDeviceIdStringN群组的主设备 ID。
familyidStringY群组所属的家庭 ID。如果为空，则默认添加到当前家庭。
roomidStringY群组所属的房间 ID。如果为空，则默认添加到“未分配”房间。
sortIntY新群组的排序方式：1 表示分配更小的序号，2 表示分配更大的序号。
deviceidListArrayY创建群组时需要加入的设备 ID 列表。无需传入 mainDeviceId。若列表中设备的 uiid 与主设备不一致，则该设备不会被加入群组。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
{
    "error": 0,
    "msg": "",
    "data": {
        "itemType": 3,
        "itemData": {
            "id": "6a0e7827a8d987dd5aef3dcd",
            "name": "groupname",
            "mainDeviceId": "1000be19e9",
            "family": {
                "familyid": "69fdd291e0ee7580ff5b28ea",
                "index": -2
            },
            "params": {},
            "uiid": 81,
            "denyFeatures": [
                "sled"
            ]
        },
        "index": -2,
        "updatedThingList": [
            {
                "itemType": 1,
                "itemData": {
                    "name": "我的智能设备",
                    "deviceid": "1000be19e9",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "model": "GSB-D04-GL",
                        "ui": "GSM单通道插座-无流量版本",
                        "uiid": 81,
                        "description": "20191025005",
                        "manufacturer": "深圳松诺技术有限公司",
                        "mac": "d0:27:01:7c:31:22",
                        "apmac": "d0:27:01:7c:31:23",
                        "modelInfo": "5d0b83f5a070b08a18a6586c",
                        "brandId": "5d0b49baa070b08a18a6585f"
                    },
                    "brandName": "嵩诺",
                    "brandLogo": "",
                    "showBrand": true,
                    "productModel": "S20GCN",
                    "tags": {},
                    "devConfig": {},
                    "settings": {
                        "opsNotify": 0,
                        "opsHistory": 1,
                        "alarmNotify": 1,
                        "wxAlarmNotify": 0,
                        "wxOpsNotify": 0,
                        "wxDoorbellNotify": 0
                    },
                    "devGroups": [
                        {
                            "groupId": "6a0e7827a8d987dd5aef3dcd",
                            "type": 1
                        }
                    ],
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -1,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [],
                    "devicekey": "45de467d-0eb5-415b-bd6f-87647f051b9b",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        }
                    },
                    "denyFeatures": [
                        "sled"
                    ],
                    "isSupportGroup": true,
                    "isSupportedOnMP": true,
                    "isSupportChannelSplit": false,
                    "deviceFeature": {}
                },
                "index": -1
            }
        ]
    }
}

27 修改设备群组

URL：/v2/device/group

请求方法：PUT

认证参数：accessToken

名称类型允许为空说明
idStringN群组 ID。
nameStringN修改后的群组名称，最大长度为 50 个字符。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

28 更改群组状态

名称类型允许为空说明
idStringN群组 ID。
paramsObjectN群组状态参数对象。接口仅负责保存该数据，不对参数内容进行处理。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

29 删除群组

URL：/v2/device/group

请求方法：DELETE

认证参数：accessToken

名称类型允许为空说明
idStringN群组 ID。

1
2
3
4
5
{
    "error": 0,
    "msg": "",
    "data": {}
}

30 更新设备群组的设备列表

URL：/v2/device/share

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
idStringN群组 ID。
deviceidListArrayN设备 ID 列表。列表中必须至少包含群组主设备的 deviceid，否则接口将返回错误。

1
2
3
4
5
6
7
{
    "error": 0,
    "msg": "",
    "data": {
        "updatedThingList": []
    }
}

31设备分享

名称类型允许为空说明
deviceidListArrayN需要分享的设备 ID 列表。
userObjectN被分享用户的信息对象。
permitIntN权限值之和，采用位运算组合。权限定义如下：1 = 新增定时器，2 = 修改定时器，4 = 删除定时器，8 = 启用定时器。
commentStringY分享备注。
shareTypeIntY分享方式，不填写时默认值为 1。1 表示静默分享，无需被分享用户确认。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
{
    "error": 0,
    "msg": "",
    "data": {
        "updatedThingList": [
            {
                "itemType": 1,
                "itemData": {
                    "name": "我的智能设备",
                    "deviceid": "1000be19e9",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "model": "GSB-D04-GL",
                        "ui": "GSM单通道插座-无流量版本",
                        "uiid": 81,
                        "description": "20191025005",
                        "manufacturer": "深圳松诺技术有限公司",
                        "mac": "d0:27:01:7c:31:22",
                        "apmac": "d0:27:01:7c:31:23",
                        "modelInfo": "5d0b83f5a070b08a18a6586c",
                        "brandId": "5d0b49baa070b08a18a6585f"
                    },
                    "brandName": "嵩诺",
                    "brandLogo": "",
                    "showBrand": true,
                    "productModel": "S20GCN",
                    "tags": {},
                    "devConfig": {},
                    "settings": {
                        "opsNotify": 0,
                        "opsHistory": 1,
                        "alarmNotify": 1,
                        "wxAlarmNotify": 0,
                        "wxOpsNotify": 0,
                        "wxDoorbellNotify": 0
                    },
                    "devGroups": [
                        {
                            "groupId": "6a0e7827a8d987dd5aef3dcd",
                            "type": 1
                        }
                    ],
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -1,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [
                        {
                            "apikey": "f3b6fed05fde710fa47f6a19dc976ce5738280d28122a7180c198ed15911f67b7f7d0ce673d69756a50443f14a35b27d",
                            "phoneNumber": "+8617589700725",
                            "comment": "This is a share",
                            "permit": 15,
                            "shareTime": 1779334651671,
                            "platform": "app",
                            "authority": {
                                "updateTimers": true
                            }
                        }
                    ],
                    "devicekey": "45de467d-0eb5-415b-bd6f-87647f051b9b",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        }
                    },
                    "denyFeatures": [
                        "sled"
                    ],
                    "isSupportGroup": true,
                    "isSupportedOnMP": true,
                    "isSupportChannelSplit": false,
                    "deviceFeature": {}
                },
                "index": -1
            }
        ],
        "resultCode": 0
    }
}

32修改设备分享的权限

URL：/v2/device/share/permit

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
deviceidStringN设备 ID。
apikeyStringN接收设备分享的用户账号 ID 标识（当前使用对称加密后的字符串）。
permitIntN修改后的权限值。具体权限定义请参见“设备分享”接口参数说明。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
{
    "error": 0,
    "msg": "",
    "data": {
        "updatedThingList": [
            {
                "itemType": 1,
                "itemData": {
                    "name": "我的智能设备",
                    "deviceid": "1000be19e9",
                    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
                    "extra": {
                        "model": "GSB-D04-GL",
                        "ui": "GSM单通道插座-无流量版本",
                        "uiid": 81,
                        "description": "20191025005",
                        "manufacturer": "深圳松诺技术有限公司",
                        "mac": "d0:27:01:7c:31:22",
                        "apmac": "d0:27:01:7c:31:23",
                        "modelInfo": "5d0b83f5a070b08a18a6586c",
                        "brandId": "5d0b49baa070b08a18a6585f"
                    },
                    "brandName": "嵩诺",
                    "brandLogo": "",
                    "showBrand": true,
                    "productModel": "S20GCN",
                    "tags": {},
                    "devConfig": {},
                    "settings": {
                        "opsNotify": 0,
                        "opsHistory": 1,
                        "alarmNotify": 1,
                        "wxAlarmNotify": 0,
                        "wxOpsNotify": 0,
                        "wxDoorbellNotify": 0
                    },
                    "devGroups": [
                        {
                            "groupId": "6a0e7827a8d987dd5aef3dcd",
                            "type": 1
                        }
                    ],
                    "family": {
                        "familyid": "69fdd291e0ee7580ff5b28ea",
                        "index": -1,
                        "members": [],
                        "guests": [],
                        "roomid": "69fdd291e0ee7580ff5b28eb"
                    },
                    "shareTo": [
                        {
                            "apikey": "f3b6fed05fde710fa47f6a19dc976ce5738280d28122a7180c198ed15911f67b7f7d0ce673d69756a50443f14a35b27d",
                            "phoneNumber": "+8617589700725",
                            "comment": "This is a share",
                            "permit": 15,
                            "shareTime": 1779334651671,
                            "platform": "app",
                            "authority": {
                                "updateTimers": true
                            }
                        }
                    ],
                    "devicekey": "45de467d-0eb5-415b-bd6f-87647f051b9b",
                    "online": false,
                    "params": {
                        "bindInfos": {
                            "alexa": []
                        }
                    },
                    "denyFeatures": [
                        "sled"
                    ],
                    "isSupportGroup": true,
                    "isSupportedOnMP": true,
                    "isSupportChannelSplit": false,
                    "deviceFeature": {}
                },
                "index": -1
            }
        ],
        "resultCode": 0
    }
}

33 取消设备分享

URL：/v2/device/share

请求方法：DELETE

认证参数：accessToken

名称类型允许为空说明
deviceidStringN设备 ID。
apikeyStringN要取消分享或修改权限的目标用户 apikey。

34 获取设备的操作历史记录

URL：/v2/device/history

请求方法：GET

认证参数：accessToken

名称类型允许为空说明
deviceidStringN设备 ID。
fromLongY时间戳（毫秒级），表示从该时间点开始向前获取更早的消息。不填写时默认使用当前时间。
numIntY最多拉取的消息数量，取值范围为 1 <= num <= 30，默认值为 30。

1
2
3
4
5
6
7
{
    "error": 0,
    "msg": "",
    "data": {
        "histories": []
    }
}

35 清除设备的操作历史记录

URL：/v2/device/history

请求方法：DELETE

认证参数：accessToken

名称类型允许为空说明
deviceidStringN设备 ID。

1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

36 查询设备的 OTA 信息

URL：/v2/device/ota/query

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
deviceInfoListArrayN需要查询的设备信息列表。数组长度必须大于 0 且小于等于 30。

1
2
3
4
5
6
7
{
    "error": 0,
    "msg": "",
    "data": {
        "otaInfoList": []
    }
}

37 修改设备配置

URL：/v2/device/settings

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
deviceidListString[]N设备 ID 列表。
settingsObjectN设备配置对象。

38删除家庭

URL：/v2/family

请求方法：DELETE

认证参数：accessToken

名称类型允许为空说明
idStringN家庭 ID。
deviceFamilyStringN用于接收被删除家庭下设备的目标家庭 ID。
switchFamilyStringN删除家庭后需要切换到的家庭 ID。

1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

39 删除房间

URL：/v2/family/room

请求方法：DELETE

认证参数：accessToken

名称类型允许为空说明
idStringN房间 ID。

1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

40 对家庭下的 Thing 做排序

URL：/v2/family/thing/sort

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
familyidStringY家庭 ID。如果为空，则表示对当前家庭下的设备或群组进行排序。
thingListArrayNThing 列表。服务端会按照列表中的顺序对对应设备或群组进行排序，例如列表中序号为 0 的设备或群组，其 index 即为 0。

1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

41 设置房间的 Thing

URL：/v2/family/room/thing

请求方法：POST

认证参数：accessToken

名称类型允许为空说明
roomidStringN房间 ID。
oldThingListArrayN原房间中的 Thing 列表。如果为空则传入空数组 []。列表 item 结构参考“对家庭下的 Thing 做排序”中的 thingList 说明。
newThingListArrayN调整后的房间 Thing 列表。

42 获取长连接

1
2
3
4
5
6
7
 {
    "error": 0,
    "reason": "ok",
    "IP": "54.223.32.89",
    "port": 443,
    "domain": "cn-pconnect8.coolkit.cc"
}

43 ws连接

{
“action”: “userOnline”,
“version”: 5.24,
“at”: “14969a91a109082fade63957507b877be078fcef”,
“userAgent”: “app”,
“apikey”: “0d7e30cf-213c-426a-8ce6-c55ab2eaee8c”,
“appid”: “oc3tvAdJPmaVOKrLv0rjCC0dzub4bbnD”,
“nonce”: “yvfq2AxS”,
“sequence”: “1571141530100”
}

44 ws 握手认证

参数名类型是否必填说明
actionstring是固定参数：userOnline
atstring是登录接口获取的 AT（access token）
apikeystring是用户 apikey（登录接口返回）
appidstring是APPID
noncestring是8位字母数字随机数
tsnumber否秒级时间戳
userAgentstring是固定参数：app
sequencestring是毫秒级时间戳
versionnumber是接口版本：8

1
2
3
4
5
6
7
8
9
{
    "error": 0,
    "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
    "config": {
        "hb": 1,
        "hbInterval": 145
    },
    "sequence": "1785807949000"
}

45 WebSocket: 设备上线离线通知（APP 接收即可）

参数名类型是否必填说明
actionstring是固定参数：sysmsg
apikeystring是用户 apikey（登录接口获取）
noncestring是8位字母数字随机数
tsnumber否秒级时间戳
deviceidstring是设备 ID
paramsobject是设备控制参数 {k:v}

无返回值

46 WebSocket: 更新设备状态

参数名类型是否必填说明
actionstring是固定参数：update
apikeystring是用户 apikey 或设备主人 apikey
selfApikeystring否接收方 apikey，接收方更新设备状态时必传
deviceidstring是设备 ID
paramsobject是需要更新的设备状态参数
userAgentstring是固定值：app 或 device
sequencestring是毫秒级时间戳

47 注销账号

URL：/v2/user/close-account

请求方法：POST

认证参数：accessToken

参数名类型是否必填说明
verificationCodeString是验证码
1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

48 修改密码

URL：/v2/user/reset-pwd

说明：用户如果忘记密码，可以使用该接口重新设置密码

请求方法：POST

认证参数：Sign

参数名类型是否必填说明
oldPasswordString是原密码
newPasswordString是新密码

1
2
3
4
5
6
{
    "error": 0,
    "msg": "",
    "data": {
    }
}

49 短信发送验证码

URL：/v2/user/sms-login

请求方法：POST

认证参数：Sign

参数名类型是否必填说明
countryCodeString是电话区号，必须以 + 开头，例如 +86
langString否APP 推送通知语言，cn 为中文，en 为英文，默认 en
phoneNumberString是手机号，需包含电话区号，例如 +8618023456789
verificationCodeString是短信验证码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
    "error": 0,
    "msg": "",
    "data": {
        "user": {
            "timezone": {
                "id": "Asia/Shanghai",
                "offset": 8
            },
            "accountLevel": 20,
            "levelExpiredAt": 1785807949000,
            "countryCode": "+86",
            "phoneNumber": "+8618639254980",
            "apikey": "0d7e30cf-213c-426a-8ce6-c55ab2eaee8c",
            "accountConsult": false,
            "appForumEnterHide": true,
            "appVersion": "5.24.0",
            "denyRecharge": false,
            "ipCountry": "CN"
        },
        "at": "29eccddb60bc4e7591f59f7757e717d3dda9694f",
        "rt": "76364e0dee566ff8ddbb345137e13dea8b7592e1",
        "region": "cn"
    }
}