生产消息接口说明
功能介绍
向指定队列发送消息,可同时发送多条消息。
- 每次最多发送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" } ]