消息队列 MQTT 版 HTTP 接口总览和限制

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

参数	说明	示例
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 标记具体可参见价格说明

HTTP 接口总览和限制

本页目录：

概述

公共请求参数

使用限制