tencent cloud

消息队列 MQTT 版

动态与公告
新功能发布记录
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 MQTT 版
应用场景
技术架构
产品系列
MQTT 协议兼容说明
开源对比
高可用
产品约束与使用配额
基本概念
开服地域
购买指南
计费概述
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
准备工作
公网接入
VPC 网络接入
用户指南
使用流程指引
配置账号权限
新建集群
管理 Topic
连接集群
查询消息
管理客户端
管理集群
查看监控和配置告警
数据集成
集成数据到云函数 SCF
集成数据到 CKafka
集成数据到 RocketMQ
开发指南
MQTT 5 高级特性
数据面 HTTP 接口说明
配置自定义域名
配置 SQL 过滤
配置点对点订阅
MQTT over QUIC
管理客户端订阅
消息增强规则
实践教程
MQTT 客户端开发注意事项
可观测能力
Topic 与通配符订阅
API 参考
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message Enhancement Rule APIs
Message APIs
Data Types
Error Codes
SDK 参考
接入点格式
Java SDK
C SDK
Javascript/Node.JS/小程序
Go SDK
iOS SDK
JavaScript SDK
Dart SDK
Python SDK
.NET
安全与合规
权限管理
常见问题
相关协议
隐私协议
数据处理和安全协议
消息队列 MQTT 版服务等级协议
联系我们
文档消息队列 MQTT 版开发指南数据面 HTTP 接口说明HTTP 接口总览和限制

HTTP 接口总览和限制

PDF
聚焦模式
字号
最后更新时间： 2026-01-30 15:23:29

概述

消息队列 MQTT 版提供基于 HTTP 协议的 API 接口，支持查询客户端在线状态和发布 MQTT 消息等功能。向服务端地址发送 HTTPS/HTTP GET 或 POST 请求，并按照接口具体说明，在请求中加入相应请求参数来调用，消息队列 MQTT 版将根据请求的处理情况，返回处理结果。接口调用时会受到流控限制，每次调用会消耗集群的 TPS 额度。特别适用于需要管理大量设备（如百万台设备）的场景，可通过 HTTP 数据流接口实现高效通信。

调用 HTTP 接口的具体方法和说明，可参见以下链接文档。
查询客户端在线状态
通过 HTTP POST 发布 MQTT 消息
动态修改客户端 Keep Alive 时间

公共请求参数

参数
说明
示例
instance-access-point
实例接入点地址，可从控制台 集群管理 > 基本信息 页面获取
mqtt-xxxx-public.mqtt.tencenttdmq.com
client_id
客户端唯一标识符 ClientId，具体规范定义可参见 Client Identifier (ClientID)
curl001

使用限制

描述
限制
支持的协议版本
HTTP 1.0 和 HTTP 1.1 协议
支持 HTTP 和 HTTPS，其中 HTTPS 建议配合证书认证使用
请求方法
查询接口支持 GET/POST
消息发布接口支持 POST
接口规格说明
查询客户端状态接口等价于一次 QoS=0 的消息发布，查询频率受限于实例 QPS Quota 约束
消息发布接口支持设置 QoS（默认 QoS=1）和 Retained 标记
具体可参见 计费概述

上一篇: 接收最大值（Receive Maximum）下一篇: 查询客户端在线状态

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈