通用参数说明¶
请求和回复中的通用参数¶
以下表格列出了 MQTT 协议的通用参数。
参数 |
数据类型 |
是否必需 |
描述 |
---|---|---|---|
id |
String |
可选 |
消息 ID 号,保留值。 |
version |
String |
必需 |
协议版本号。 |
params |
JSON |
请求中必需 |
请求中的参数。可以为 int 或 dict 格式。 |
method |
String |
请求中必需 |
请求方法。 |
code |
Integer |
响应中必需 |
结果返回码,继承云端协议返回码。通用结果返回码,参见 通用返回错误码。 |
data |
JSON |
可选 |
返回的详细信息。根据返回值的不同其可以为数组格式或者字典格式。 |
通用返回错误码 ¶
下表列举了所有 MQTT topic 通用的返回错误码。对于某一个 topic 独有的返回码,参见有关 topic 的说明文档。
错误码 |
错误信息 |
描述 |
---|---|---|
1220 |
Payload format error |
Payload 包含了非法 JSON 格式。 |
1251 |
Payload is empty |
Payload 是空的。 |
1260 |
Methods not consistent |
MQTT 消息中的方法和 topic 不匹配。 |
1008 |
Msg size is too large, discard the message |
MQTT 消息大小超过限制。 |
1009 |
Publish to topic with no write permission |
不支持该 MQTT topic。或者向该 topic 发布数据的设备尚未登录 EnOS。 |