生成 Wi-Fi 设备配网 Token

最近更新时间:2025-12-29 15:26:13

我的收藏

1. 接口描述

接口请求域名: iot.cloud.tencent.com/api/exploreropen/tokenapi 本接口(AppCreateDeviceBindToken)用于生成 Wi-Fi 配网任务的随机 Token。

2. 输入参数

名称
类型
必选
描述
Action
String
公共参数,本接口取值:AppCreateDeviceBindToken。
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuid。定位问题时,需要提供该次请求的 RequestId。
AccessToken
String
公共参数,AccessToken 用于对一个已经登录的用户鉴权。
TokenLengthType
String
可选
默认为空,Token 长度为32字符,若传1,Token 长度为6位字符。

3. 输出参数

名称
类型
描述
RequestId
String
RequestId。
Token
String
生成的配网 Token。

4. 示例

示例1 生成 Wi-Fi 设备配网 Token

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"Action": "AppCreateDeviceBindToken",
"AccessToken":"bf******************d098",
"RequestId": "f92406b3-5a9a-4fe8-bc43-45e3d794bb68"
}
输出示例:成功
{
"Response": {
"Data": {
"Token": "d7*************1b3b",
"RequestId": "f92406b3-5a9a-4fe8-bc43-45e3d794bb68"
}
}
}
输出示例:失败
{
"Response": {
"Error": {
"Code": "InvalidParameterValue.InvalidAccessToken",
"Message": "Token无效"
},
"RequestId": "f92406b3-5a9a-4fe8-bc43-45e3d794bb68"
}
}

5. 错误码

错误码
描述
InvalidParameter
无效参数。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.TokenInfoSaveError
Token 保存失败。