1签名规则

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

是 Postman 中的 变量占位符,表示:读取当前作用域中名为 sign 的变量值,并在发送请求前替换成真实内容。 # 2登录 入参: | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | --- | ---------------------------------- | | 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 时,表示账号不在当前区域,客户端需要根据返回的区域信息重新去其它区调用登录接口。
入参:

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

注意: emailphoneNumber 必须二选一填写,至少提供其中一个,否则接口会返回错误。

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

4查询区域

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

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

5重置密码

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

注意: emailphoneNumber 必须二选一填写,至少提供其中一个,否则接口会返回错误。

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

入参

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

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

7更新用户信息

入参:

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

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

8退出登录

请求参数:无

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

9首页

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

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
{
"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新增房间

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修改家庭名称

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

13修改房间名称

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

14切换家庭

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

15房间排序


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列表

名称类型允许为空说明
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 列表信息

名称类型允许为空说明
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获取设备或群组的状态

名称类型允许为空说明
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更新设备或群组的状态

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

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

21 添加wifi设备

参数名类型是否必填说明
nameString设备名称
deviceidString设备 ID
settingsObject用户设置,未传则使用默认值
ifrCodeString红外设备码值
digestStringSHA256(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设备

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

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

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

24 删除设备

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

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

25 修改设备标签

名称类型允许为空说明
deviceidStringN设备 ID。
typeStringY修改类型,不填写时默认值为 replacereplace 表示覆盖,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 新增设备群组

名称类型允许为空说明
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 修改设备群组

名称类型允许为空说明
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 删除群组

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

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

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

名称类型允许为空说明
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分享方式,不填写时默认值为 11 表示静默分享,无需被分享用户确认。

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修改设备分享的权限

名称类型允许为空说明
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 取消设备分享

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

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

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

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

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

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

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

36 查询设备的 OTA 信息

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

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

37 修改设备配置

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

38删除家庭

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

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

39 删除房间

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

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

40 对家庭下的 Thing 做排序

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

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

41 设置房间的 Thing

名称类型允许为空说明
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(登录接口返回)
appidstringAPPID
noncestring8位字母数字随机数
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(登录接口获取)
noncestring8位字母数字随机数
tsnumber秒级时间戳
deviceidstring设备 ID
paramsobject设备控制参数 {k:v}

无返回值

46 WebSocket: 更新设备状态

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

47 注销账号

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

48 修改密码

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

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

49 短信发送验证码

参数名类型是否必填说明
countryCodeString电话区号,必须以 + 开头,例如 +86
langStringAPP 推送通知语言,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"
}
}