批量发布消息
更新时间 2025-12-03 09:40:11
最近更新时间: 2025-12-03 09:40:11
接口功能介绍
批量发布消息
接口约束
无
URI
POST /v3/api/publishMessageBatch
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池编码 | bb9fdb42056f11eda1610242ac110002 华东1 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| prodInstId | 是 | String | 实例ID | 445d30ce3d5d40a2a79dc444a8c83859 | |
| data | 是 | Array of Objects | data | data | |
| 表 data |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| topics | 是 | String | 订阅的topic列表，支持多个topic，以逗号分隔 | t/a,t/b,t/c | |
| clientid | 是 | String | 客户端id | ||
| qos | 是 | String | 取值为0到2，通信等级，默认为0 | ||
| payload | 是 | String | 消息文本 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| message | String | 描述状态 | ||
| statusCode | String | 800-成功 其他失败 | ||
| error | String | 错误码 | ||
| returnObj | Object | 返回对象 |
枚举参数
无
请求示例
请求url
https://mqtt-global.ctapi.ctyun.cn/v3/api/publishMessageBatch
请求头header
{
"regionId":"bb9fdb42056f11eda1610242ac110002"
}
请求体body
{
"prodInstId": "445d30ce3d5d40a2a79dc444a8c83859",
"data": [
{
"topics": "t/a,t/b,t/c",
"clientid": "mqtt-a",
"qos": 0,
"payload": "test messsage"
}
]
}
响应示例
{
"statusCode":800
}
状态码
请参考 状态码
错误码
请参考 错误码
