tencent cloud

物联网通信

动态与公告
产品动态
产品简介
产品概述
产品功能
产品优势
应用场景
产品限制
基本概念
快速入门
快速开始
场景一：设备互通
场景二：设备状态上报与状态设置
MQTT.fx接入指南
控制台使用手册
产品管理
规则引擎
子账号访问IoT
固件升级
资源管理
证书管理
开发者手册
功能组件
签名方法
设备身份认证
设备接入协议
网关子设备
消息通信
设备影子
设备固件升级
设备远程配置
资源管理
设备日志上报
NTP服务
设备端接入手册
设备接入概述
基于C SDK接入
基于 Android SDK 接入
基于 Java SDK 接入
基于 Python SDK 接入
API 文档
History
Introduction
API Category
Making API Requests
Device Shadow APIs
Device APIs
CA Certificate APIs
Product APIs
Data Types
Error Codes
常见问题
一般性问题
设备接入和上报问题
规则引擎问题
控制台相关问题
IoT Hub 政策
隐私协议
数据处理和安全协议
词汇表
文档物联网通信开发者手册设备接入协议设备基于HTTP接入

设备基于HTTP接入

PDF
聚焦模式
字号
最后更新时间： 2024-12-27 15:44:26

参数说明

设备上报消息时需携带 ProductId、DeviceName 和 TopicName 向平台发起 http/https 请求，请求接口及说明参数如下：
请求的 URL 为：
https://ap-guangzhou.gateway.tencentdevices.com/device/publish
http://ap-guangzhou.gateway.tencentdevices.com/device/publish
请求方式：Post

请求参数

参数名称
必选
类型
描述
ProductId
是
String
产品 Id
DeviceName
是
String
设备名称
TopicName
是
String
发布消息的 Topic 名称
Payload
是
String
发布消息的内容
PayloadEncoding
否
String
发布消息的编码。目前只支持base64编码，不传默认发送原始的消息内容
Qos
是
Integer
消息 Qos 等级
说明：
接口只支持 application/json 格式。

签名生成

对请求报文进行签名分为两种，密钥认证使用 HMAC-sha256 算法，证书认证使用 RSA_SHA256 算法，详情请参见 签名方法。

平台返回参数

参数名称
类型
描述
RequestId
String
请求 Id

示例代码

请求包

POST https://ap-guangzhou.gateway.tencentdevices.com/device/publish
Content-Type: application/json
Host: ap-guangzhou.gateway.tencentdevices.com
X-TC-Algorithm: HmacSha256
X-TC-Timestamp: 155****065
X-TC-Nonce: 5456
X-TC-Signature: 2230eefd229f582d8b1b891af7107b915972407****78ab3738f756258d7652c
{"DeviceName":"AAAAAA","Payload":"123","ProductId":"G8N****AHB","Qos":1,"TopicName":"G8N****AHB/AAAAAA/data"}

返回包

{
  "Response": {
    "RequestId": "f4da4f1f-d72e-40f1-****-349fc0072ba0"
  }
}


上一篇: 设备基于CoAP接入下一篇: 设备接入地域说明

帮助和支持

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

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

文档反馈