生产消息接口说明
功能介绍
向指定队列发送消息,可同时发送多条消息。
- 每次最多发送10条。
- 每次发送的消息总负载不超过2MB。
- endpoint为https://{rest_connect_address}:9292,通过指定实例接口查询rest_connect_address的IP地址。
URI
POST /v1/topic/{topic_name}/messages
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
topic_name |
String |
是 |
主题名称。 |
请求消息
请求参数
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
messages |
Array |
是 |
消息列表,数组大小不能超过10,且不能为空数组。 |
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
content |
Object |
是 |
消息内容。 |
|
id |
String |
是 |
消息序号,序列号不能重复。 |
请求示例
{
"messages": [
{
"content": "hello roma-1",
"id": "1"
},
{
"content": "hello roma-2",
"id": "2"
},
{
"content": "hello roma-3",
"id": "3"
}
]
}
响应消息
响应参数
|
参数 |
类型 |
说明 |
|---|---|---|
|
state |
String |
结果状态。成功为success,失败为fail。 |
|
id |
String |
消息序号。 |
响应示例
[
{
"state": "success",
"id": "1"
},
{
"state": "success",
"id": "2"
},
{
"state": "success",
"id": "3"
}
]