# Message Publish
# Message Publish
# URI
POST /mqtt/publish
# Request Message
Name | Type | Required | Default | Description |
---|---|---|---|---|
topic | String | Optional | For topic and topics, with at least one of them specified | |
topics | String | Optional | Multiple topics separated by , . This field is used to publish messages to multiple topics at the same time | |
clientid | String | Required | Client identifier | |
payload | String | Required | Message body | |
encoding | String | Optional | plain | The encoding used in the message body. Currently only plain and base64 are supported. Default is plain |
qos | Integer | Optional | 0 | QoS level |
retain | Boolean | Optional | false | Whether it is a retained message, default is false |
# Response Message
Name | Type | Description |
---|---|---|
code | Integer | 0 |
# Request Example
curl -u app_id:app_secret -X POST -d '{"topic": "topic/a","clientid": "emqx_c_1","payload": "Hello EMQX"}' {api}/mqtt/publish
1
# Response Example
{
"code": 0
}
1
2
3
2
3
# Batch Message Publish
# URI
POST /mqtt/publish_batch
# Request Message
Name | Type | Required | Default | Description |
---|---|---|---|---|
[].]opic | String | Optional | For topic and topics, with at least one of them specified | |
[].topics | String | Optional | Multiple topics separated by , . This field is used to publish messages to multiple topics at the same time | |
[].clientid | String | Required | Client identifier | |
[].payload | String | Required | Message body | |
[].encoding | String | Optional | plain | The encoding used in the message body. Currently only plain and base64 are supported. Default is plain |
[].qos | Integer | Optional | 0 | QoS level |
[].retain | Boolean | Optional | false | Whether it is a retained message, default is false |
# Response Message
Name | Type | Description |
---|---|---|
code | Integer | 0 |
# Request Example
curl -u app_id:app_secret -X POST -d '[{"topic": "a/b","clientid": "emqx_c_1","payload": "Hello EMQX"},{"topic": "a/b","clientid": "emqx_c_1","qos": 2,"payload": "Hi EMQX"}]' {api}/mqtt/publish_batch
1
# Response Example
{
"data": [
{
"topic": "a/b",
"code": 0
},
{
"topic": "a/b",
"code": 0
}
],
"code": 0
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
What’s on this page