官方文档

腾讯云设备安全「查询设备标识」API（DescribeTrustedID）原文标题：设备安全查询设备标识_腾讯云

发表时间：2025-09-12采集时间：2026-10-09 10:34:50来源：cloud.tencent.com原文语言：zh状态：完整

原始链接：https://cloud.tencent.com/document/product/1628/81017

内容概要总结

腾讯云设备安全（T-Sec Device Safety）的 API 文档「查询设备标识」，最近更新于 2025-09-12。接口请求域名为 tds.tencentcloudapi.com，Action 取值为 DescribeTrustedID，Version 为 2022-08-01，Region 无需传递。

输入参数为 DeviceToken（必选，客户端通过 SDK 获取的设备 Token，示例值 eHh4eHh4eHg=）。输出参数包括 Openid（设备匿名标识，示例值 85ADB490D96D6A0044D00798）、AppVersion、Brand、ClientIp（示例值为一个 IPv6 地址 2409:8929:270b:316:16f2:2dd6:2987:390a）、Model、NetworkType、PackageName、Platform（2-Android，3-iOS，4-H5，5-微信小程序）、SystemVersion、SdkBuildNo、RequestId。

文档给出完整的 POST 请求示例与 JSON 返回示例（如 Openid A10254A0046CEA0448A387BF、Brand HONOR、Model LLD-AL20、ClientIp 223.73.63.151 等），并列出开发者资源（API 平台、API Inspector、多语言 SDK）与业务错误码 ResourceInsufficient（资源不足）。

原文内容（原文即中文）

文档中心>设备安全>API 文档>设备安全查询相关接口>查询设备标识

查询设备标识

最近更新时间：2025-09-12 03:45:37

本页目录：

1. 接口描述

接口请求域名： tds.tencentcloudapi.com 。

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：DescribeTrustedID。
Version	是	String	公共参数，本接口取值：2022-08-01。
Region	否	String	公共参数，本接口不需要传递此参数。
DeviceToken	是	String	客户端通过SDK获取的设备Token 示例值：eHh4eHh4eHg=

3. 输出参数

参数名称	类型	描述
Openid	String	设备匿名标识示例值：85ADB490D96D6A0044D00798
AppVersion	String	App版本信息示例值：6.8.50
Brand	String	品牌示例值：OPPO
ClientIp	String	客户端IP 示例值：2409:8929:270b:316:16f2:2dd6:2987:390a
Model	String	机型示例值：PEMM00
NetworkType	String	网络类型示例值：1
PackageName	String	应用包名示例值：com.xx.xxx
Platform	String	平台（2-Android，3-iOS，4-H5，5-微信小程序）示例值：2
SystemVersion	String	系统版本示例值：11
SdkBuildNo	String	SDK版本号示例值：74
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询设备标识

输入示例

POST / HTTP/1.1
Host: tds.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeTrustedID
<公共请求参数>
{
 "DeviceToken": "v2:s6kBRbiOKZp/kenOxxxxxxxxx"
}

输出示例

{
 "Response": {
 "Openid": "A10254A0046CEA0448A387BF",
 "Brand": "HONOR",
 "SdkBuildNo": "75",
 "AppVersion": "1.0.0",
 "Platform": "2",
 "SystemVersion": "10",
 "RequestId": "19a13dc5-1c2c-4d0e-bd08-13534b53c8f4",
 "NetworkType": "0",
 "Model": "LLD-AL20",
 "PackageName": "a.b.c",
 "ClientIp": "223.73.63.151"
 }
}