# 消息发布

# 消息发布

# URI

POST /mqtt/publish

# 请求消息

名称类型描述
topicString主题,与 topics 至少指定其中之一
topicsString, 分割的多个主题,使用此字段能够同时订阅多个主题
clientidString客户端标识符
payloadString消息正文
encodingString消息正文使用的编码方式,目前仅支持 plainbase64 两种,默认为 plain
qosIntegerQoS 等级,默认为 0
retainBoolean是否为保留消息,默认为 false

# 响应消息

名称类型描述
codeInteger0

# 请求示例

$ curl -u app_id:app_secret -X POST {api}/mqtt/publish
1
{
  "topic": "topic/a",
  "clientid": "emqx_c_1",
  "payload": "Hello EMQX"
}
1
2
3
4
5

# 响应示例

{
  "code": 0
}
1
2
3

# 批量消息发布

# URI

POST /mqtt/publish_batch

# 请求消息

名称类型描述
[].topicString主题,与 topics 至少指定其中之一
[].topicsString, 分割的多个主题,使用此字段能够同时订阅多个主题
[].clientidString客户端标识符
[].payloadString消息正文
[].encodingString消息正文使用的编码方式,目前仅支持 plainbase64 两种,默认为 plain
[].qosIntegerQoS 等级,默认为 0
[].retainBoolean是否为保留消息,默认为 false

# 响应消息

名称类型描述
codeInteger0

# 请求示例

$ curl -u app_id:app_secret -X POST {api}/mqtt/publish_batch
1
[
  {
    "topic": "a/b",
    "clientid": "emqx_c_1",
    "payload": "Hello EMQX"
  },
  {
    "topic": "a/b",
    "clientid": "emqx_c_1",
    "qos": 2,
    "payload": "Hi EMQX"
  }
]
1
2
3
4
5
6
7
8
9
10
11
12
13

# 响应示例

{
  "code": 0
}
1
2
3