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 政策
隐私协议
数据处理和安全协议
词汇表
文档物联网通信开发者手册设备身份认证动态注册接口说明

动态注册接口说明

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

参数说明

设备动态注册时需携带 ProductId 和 DeviceName 向平台发起http/https请求，请求接口及参数如下：
请求的 URL 为：
https://ap-guangzhou.gateway.tencentdevices.com/device/register
http://ap-guangzhou.gateway.tencentdevices.com/device/register
请求方式：Post

请求参数

参数名称
必选
类型
描述
ProductId
是
string
产品 Id
DeviceName
是
string
设备名称
说明：
接口只支持 application/json 格式。

签名生成

使用 HMAC-sha256 算法对请求报文进行签名，详情请参见 签名方法。

平台返回参数

参数名称
类型
描述
RequestId
String
请求 Id。
Len
Int64
返回的 Payload 长度。
Payload
String
返回的设备注册信息。该数据通过加密后返回，需要设备端自行解密处理。
说明：
加密过程是将原始 json 格式的 Payload 转为字符串后进行 AES 加密，再进行 base64 加密。AES 加密算法为 CBC 模式，密钥长度128，取 productSecret 前16位，偏移量为长度16的字符“0”。
原始 Payload 内容说明：
key
value
描述
encryptionType
1
加密类型。
1表示证书认证
2表示密钥认证
psk
1239466501
设备密钥，当产品认证类型为密钥认证时有此参数。
clientCert
-
设备证书文件字符串格式，当产品认证类型为证书认证时有此参数。
clientKey
-
设备私钥文件字符串格式，当产品认证类型为证书认证时有此参数。

示例代码

请求包

POST https://ap-guangzhou.gateway.tencentdevices.com/device/register
Content-Type: application/json
Host: ap-guangzhou.gateway.tencentdevices.com
X-TC-Algorithm: HmacSha256
X-TC-Timestamp: 1551****65
X-TC-Nonce: 5456
X-TC-Signature: 2230eefd229f582d8b1b891af7107b91597****07d778ab3738f756258d7652c
{"ProductId":"ASJ****GX","DeviceName":"xyz"}

返回包

{
  "Response": {
    "Len": 53,
    "Payload": "031T01DWAoqFePDt71VuZXuLzkUzbIhGOnvMzpAFtNgOjagyFNHVSostNl9ztvhOuRx0dMM/DMoWAXQCfL7jyA==",
    "RequestId": "f4da4f1f-d72e-40f1-****-349fc0072ba0"
  }
}


Payload 数据解析示例

说明：
以下数据仅提供您进行测试使用，在您正式使用时，请务必保证您的信息不被泄露。
1. Payload 原始内容为
s6FB3a1BA/YYbcmSE12XpeDVmQNDcf1QgVD141RRbmmAnFwQfp1ECAu5O016mCOvYlJJ6V59yM4OqQSiWphfTg==
2. Base64 解码后
b3a141ddad4103f6186dc992135d97a5e0d599034371fd508150f5e354516e69809c5c107e9d44080bb93b4d7a9823af625249e95e7dc8ce0ea904a25a985f4e
3. AES 解密
产品密钥：hzvf5LF9S0isvBhDSauWMaIk
解密后数据：{"encryptionType":2,"psk":"lDZ6Uqt+I9E0wW7rvDUs7Q=="}
上一篇: 产品级密钥认证下一篇: 设备基于 TCP 的 MQTT 接入

帮助和支持

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

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

文档反馈