文档中心>消息队列 CMQ 版

发送消息

最近更新时间:2023-08-14 16:18:51

我的收藏

接口描述

本接口(SendMessage)用于发送一条消息到指定的队列。
公网/内网接口请求域名,在 TDMQ CMQ 版控制台队列服务 > API 请求地址处复制。CMQ 的 API 调用地址示例如下:
公网地址:https://cmq-gz.publicXXX.tencenttdmq.com
内网地址:http://gz.mqadapter.cmq.tencentyun.com
注意:
不同地域的 API 调用地址 URL 会有所变化。
任何时候(包括内测期间),如果使用外网域名产生公网下行流量,都会收取流量费用。 所以强烈建议服务在腾讯云上的用户使用内网域名,内网不会产生流量费用。

输入参数

以下请求参数列表仅列出了接口请求参数,其它参数请参见 公共请求参数 页面。
参数名称
是否必选
类型
描述
queueName
String
队列名字,在单个地域同一账号下唯一。队列名称是一个不超过64个字符的字符串,必须以字母为首字符,剩余部分可以包含字母、数字和横划线(-)。
msgBody
String
消息正文。至少1Byte,最大长度受限于设置的队列消息最大长度属性。
delaySeconds
Int
单位为秒,表示该消息发送到队列后,需要延时多久用户才可见该消息。

输出参数

参数名称
类型
描述
code
Int
0:表示成功,others:错误,详情请参见 公共错误码
message
String
错误提示信息。
requestId
String
服务器生成的请求 ID,出现服务器内部错误时,用户可提交此 ID 给后台定位问题。
msgId
String
服务器生成消息的唯一标识 ID。

错误码

详情请参见 公共错误码

示例

输入:
https://domain/v2/index.php?Action=SendMessage &queueName=test-queue-123 &msgBody=helloworld &<公共请求参数>
输出:
{
"code" : 0,
"message" : "",
"requestId":"14534664555",
"msgId":"123345346"
}