API 接口说明
接口方式
Base URL
- 中国节点: https://cn.apitd.net/device/profile/log
- 美国节点: https://us.apitd.net/device/profile/log
- 新加坡节点:https://sg.apitd.net/device/profile/log
- 德国节点: https://de.apitd.net/device/profile/log
- 印尼节点: https://id.apitd.net/device/profile/log
- 巴基斯坦: https://pk.apitd.net/device/profile/log
- 泰国节点: https://th2.apitd.net/device/profile/log
API
URL | 请求方式 | Content-Type | 输出格式 | 字符集 |
---|---|---|---|---|
api-base-url?partner_code=xxx&partner_key=xxx | POST | application/json | JSON | UTF-8 |
认证参数
字段 | 类型 | 含义 | 建议 | 备注 |
---|---|---|---|---|
partner_code | String | 合作方标识 | 必须 | 由 TD 分配 |
partner_key | String | 合作方密钥 | 必须 | 由 TD 分配 |
请求参数
字段 | 类型 | 含义 | 建议 | 备注 |
---|---|---|---|---|
black_box | String | 用来获取设备信息的凭证 | 必须 | 通过 SDK 获取 |
请求示例
{
"black_box": "aGPH1658920283672ropYaFxT7"
}
响应参数
字段 | 类型 | 含义 | 响应 | 备注 |
---|---|---|---|---|
code | Integer | 接口状态码 | 存在 | 参考状态码说明 |
message | String | 状态信息 | 存在 | 在接口异常状态下会输出具体的异常原因,参考状态码说明 |
sequence_id | String | 响应唯一码 | 存在 | 用于跟踪每次请求与响应的唯一标识 |
anonymous_id | String | 匿名 ID | 存在 | 格式固定,长度48位的字符 |
device_os | String | 设备类型 | 存在 | Android、iOS、Web |
channel | String | 渠道 | 存在 | 渠道 |
device_detail | Object | 设备详情 | 存在 | 参考设备详情说明 |
device_risk_score | Integer | 设备风险评分 | 存在 | 范围为 0 - 10000,支持自定义,文档介绍参考风险分 |
device_risk_label | Array | 设备风险标签列表 | 存在 | 参考设备风险标签列表说明 |
device_risk_tools | Object | 设备风险工具 | 存在 | 参考设备风险工具说明 |
device_history_risk_label | Array | 历史风险标签列表 | 存在 | 参考历史风险标签参数说明 |
设备详情
不同的设备类型对应的设备详情字段不尽相同,下面分别罗列了不同的设备类型对应的设备详情
Android
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
app_version | String | app 版本 | 例如 "4.1.6" |
system_version | String | Android 系统版本 | 例如 "6.0.1" |
api_version | String | Android API 版本 | 例如 "23" |
fp_version | String | SDK 版本 | 例如 "4.1.6" |
model | String | 设备型号 | 例如 "2014811" |
brand | String | 设备品牌 | 例如 "Xiaomi" |
device_name | String | 设备名称 | 例如 "HM2014811" |
network_type | String | 网络类型 | 例如 "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown" |
ip | String | IP 地址 | 例如 "123.157.153.130" |
time_zone | String | 时区 | 例如 "UTC+08:00" |
startup_time | Long | 开机时间 | 例如 1741660150575 |
up_time | Long | 开机时长 | 例如 "568273951" |
charge_state | String | 充电状态 | 例如 "charging"、"full"、"not_charging"、"discharging"、"unknown" |
battery_level | Integer | 电量 | 范围为 0 - 100 |
screen_resolution | String | 屏幕分辨率 | 宽 x 高,例如:"720x1280" |
screen_brightness | Integer | 屏幕亮度 | 范围为 -1 - 256 |
total_memory | Long | 总内存大小 | 字节数 |
available_memory | Long | 可用内存大小 | 字节数 |
total_storage | Long | 总存储大小 | 字节数 |
available_storage | Long | 可用存储大小 | 字节数 |
latitude | Double | 纬度 | 精确到小数点后 6 位,例如 30.282331 |
longitude | Double | 经度 | 精确到小数点后 6 位,例如 120.011395 |
carrier | String | 移动运营商 | 例如 "中国电信,中国移动" |
bssid | String | 无线 MAC 地址 | 例如 "00:1a:8c:a0:69:0a" |
wifi_ip | String | 无线 IP 地址 | 例如 "10.57.3.135" |
device_svn | String | 设备软件版本号 | 例如 "07" |
hardware | String | 硬件 | 例如 "qcom" |
dns_address | String | DNS 地址 | 例如 "211.137.32.178" |
product | String | 产品代号 | 例如 "A37T" |
host | String | HOST | 例如 "qh-miui-ota-offline07" |
sim_operator | String | SIM 卡运营商 | 例如 "中国电信,中国移动" |
ssid | String | 无线网络名称 | 例如 "xiaoming 的 wifi" |
vpn_ip | String | VPN IP 地址 | 例如 "10.251.37.229" |
cell_ip | String | 本地 IP 地址 | 例如 "10.3.4.9" |
current_time | Long | 当前时间 | 例如 "14816942" |
package_name | String | 应用包名 | 例如 "cn.tongdun. android&3.0.0" |
language | String | 语言 | 例如 "zh" |
android_id | String | Android ID | 例如 "952b0b1edda80b44" |
cpu_hardware | String | CPU 硬件 | 例如 "ARMv7 Processor rev 0 (v7l)" |
cpu_type | String | CPU 型号 | 例如 "Qualcomm Technologies" |
baseband_version | String | 基带版本 | 例如 "MPSS.DPM.1.0.c7. 18-00023" |
mnc | String | 移动网络码 | 例如 "01" |
mcc | String | 移动国家码 | 例如 "460" |
installed_packages | String | 安装的应用包名 | 例如 "[{\"package\":\"com.miui.screenrecorder\",\"name\":\"-\"},{\"package\":\"com.miui.fm\",\"name\":\"-\"}] " |
running_packages | String | 运行的应用包名 | 例如 "com.xiaomi.shop" |
ipv6 | String | IPv6 | 例如 "fe80::bfd7:21d8:318a:693b" |
sign_md5 | String | 签名 MD5 | 例如 "6fb472cac420436b773a6325d4cdd7bd" |
proxy_info | String | 代理配置 | 例如 "10.2.3.4:8080" |
country_iso | String | 国家代码 | 例如 "cn,cn" |
aid | String | Google个性化广告ID | 例如 "db13e159-1058-46fc-a4dc-4d2f8197f3af" |
vpn_true_ip | String | VPN 真实 IP 地址 | 例如 "123.157.153.130" |
audio_mode | Integer | ⾳频状态 | 例如“0 -正常模式, 1 -铃声模式 , 2 -通话模式, 3 - 通信模式, 4 - 通话筛选进行中” |
iOS
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
app_version | String | app 版本 | 例如 "1.0.3" |
system_version | String | iOS 系统版本 | 例如 "10.2.1" |
fp_version | String | SDK 版本 | 例如 "4.1.2" |
model | String | 设备型号 | 例如 "iPhone 6s" |
device_name | String | 设备名称 | 例如 "iPhone" |
network_type | String | 网络类型 | 例如 "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown" |
ip | String | IP 地址 | 例如 "123.157.153.130" |
time_zone | String | 时区 | 例如 "UTC+08:00" |
startup_time | Long | 开机时间 | 例如 1741660150575 |
up_time | Long | 开机时长 | 例如 "568273951" |
charge_state | String | 充电状态 | 例如 "charging"、"unplugged"、"unknown" |
battery_level | Integer | 电量 | 范围为 0 - 100 |
screen_resolution | String | 屏幕分辨率 | 宽 x 高,例如:"720x1280" |
screen_brightness | Integer | 屏幕亮度 | 范围为 0 - 100 |
total_memory | Long | 总内存大小 | 字节数 |
total_storage | Long | 总存储大小 | 字节数 |
available_storage | Long | 可用存储大小 | 字节数 |
latitude | Double | 纬度 | 精确到小数点后 6 位,例如 30.282331 |
longitude | Double | 经度 | 精确到小数点后 6 位,例如 120.011395 |
current_time | Long | 当前时间 | 例如 "1687680661250" |
cell_ip | String | 本地 IP 地址 | 例如 "10.5.2.39" |
wifi_ip | String | 无线IP地址 | 例如 "192.168.10.111" |
language | String | 语言 | 例如 "en " |
carrier | String | 移动运营商 | 例如 "中国移动" |
mnc | String | 移动网络码 | 例如 "0" |
mcc | String | 移动国家码 | 例如 "460" |
country_iso | String | 国家代码 | 例如 "cn" |
bundle_id | String | Bundle ID | 例如 "cn.fraudmetrix. FMDeviceManager" |
proxy_info | String | 代理配置 | 例如 "10.2.3.4:8080" |
ssid | String | 无线网络名称 | 例如 "TP-LINK_03FE" |
bssid | String | 无线mac地址 | 例如 "80:2f:3e:dd:03:fe" |
dns_address | String | DNS 地址 | 例如 "192.168.10.1" |
vpn_ip | String | VPN IP 地址 | 例如 "10.32.3.98" |
ipv6 | String | IPv6 | 例如 "fe80::bfd7:21d8:318a:693b" |
idfa | String | 广告追踪标示符 | 例如 "5D26C201-7FEF-44A6-B57A-1D10E2E2EC63" |
issue_region | String | 设备发行地区 | 例如 "CH/A" |
vpn_true_ip | String | VPN 真实 IP 地址 | 例如 "123.157.153.130" |
microphone_use_state | Integer | 麦克风状态 | 例如-1:⽆可⽤⻨克⻛,0:未处于通话状态,1:处于通话状态 |
Web
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
browser_name | String | 浏览器名称 | 例如 "Chrome" |
browser_version | String | 浏览器版本 | 例如 "56.0.2924.87" |
fp_version | String | SDK 版本 | 例如 "3.8.5" |
user_agent | String | 浏览器 UA | 例如 "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36" |
url | String | URL | 例如 "file:///Users/td/Documents/td/fp/demo_web.html " |
device_type | String | 设备类型 | 例如 "Mac" |
os | String | 设备操作系统 | 例如 "Mac OS" |
ip | String | IP 地址 | 例如 "123.157.153.130" |
time_zone | String | 时区 | 例如 "UTC+08:00" |
screen_resolution | String | 屏幕分辨率 | 宽 x 高,例如:"720x1280" |
language | String | 语言 | 例如 "zh-CN" |
referer | String | 请求来源 | 例如:"http://10.57.30.164:8088/ " |
canvas | String | 帆布指纹 | 例如 "c8a8455d02d7cec9edbe980b6b9e0ff8" |
current_time | Long | 当前时间 | 例如 "1687680661250" |
vpn_true_ip | String | VPN 真实 IP 地址 | 例如 "123.157.153.130" |
latitude | Double | 纬度 | 精确到小数点后 6 位,例如 30.2823 |
longitude | Double | 经度 | 精确到小数点后 6 位,例如 120.0113 |
设备风险标签
字段 | 类型 | 适用平台 | 描述 | 备注 |
---|---|---|---|---|
abnormal_time | String | Android, iOS, 小程序 | 本机时间异常 | 设备时间与实际时间偏差过大 |
emulator | String | Android, iOS, Web, 小程序,Harmony | 设备为模拟器 | 设备为电脑上安装的模拟器 |
incognito_mode | String | Web | 隐身模式 | |
headless_mode | String | Web,小程序 | 虚拟浏览器 | |
abnormal_useragent | String | Web, 小程序 | UA 异常 | |
debugger_detected | String | Android, iOS, Web,小程序(微信) | 检测到调试器 | SDK 工作期间检测到调试器 |
hook_tool_detected | String | Android, iOS,Web | 检测到改机工具 | |
device_info_tampered | String | Android, iOS,Web,小程序 | 设备参数被篡改 | 检测到设备信息被篡改 |
group_control | String | Android, iOS | 群控 | 使用云手机、群控设备 |
no_sim | String | Android,Harmony,iOS | 未插sim卡 | 设备未插手机卡 |
abnormal_device_attr | String | iOS, Web, 小程序 | 设备参数异常 | 哈希校验异常,某些字段命中特殊值 |
script_tempered | String | Web | 脚本被篡改 | |
virtual_machine | String | Web | 设备为虚拟机 | 检测到设备为虚拟机 |
local_debug | String | Web | 本地调试 | 检测到本地调试 |
adb_link | String | Android | ADB 调试 | 移动设备连接 PC 端,处于 ADB 调试状态 |
repackaged | String | Android, iOS | 二次打包 | |
proxy_detected | String | Android, Harmony,iOS, 小程序(微信) | 使用代理 | |
root | String | Android | root | |
jail_break | String | iOS | 越狱 | |
vpn_detected | String | Android, iOS,Web,Harmony | 使用 VPN | |
replay_attacks | String | Android, Harmony,iOS, Web, 小程序 | 重放攻击 | 同一份设备数据被多次上报 |
cookie_tempered | String | Android,Harmony, iOS, Web, 小程序 | Cookie 被篡改 | 客户端设备指纹的 Cookie 被篡改 |
crawler | String | Web | 爬虫 | |
malicious_crx | String | Web | 恶意扩展程序 | |
debug_tool | String | Web | 调试器工具 | |
app_multiple_running | String | Android,iOS | 应用多开 | |
sys_multiple_running | String | Android | 系统多开 | |
gps_fake | String | Android, iOS, 小程序(微信) | 虚拟定位 | |
risk_rom | String | Android | 疑似风险ROM | 非原生出厂设备的ROM |
camera_fake | String | Android, iOS | 摄像头劫持 | |
suspected_reset | String | Android,iOS | 疑似重置 | |
short_uptime | String | Android,iOS,Harmony | 开机时间过短 | |
screen_sharing | String | Android,iOS,Harmony | 屏幕共享 | |
cloud_phone | String | Android,iOS, 小程序(微信) | 云手机 | |
offline_attack | String | Web | 脱机攻击 | |
anti_association_browser | String | Web | 防关联浏览器 | |
device_call | String | Android,iOS,Harmony | 通话状态 |
设备风险工具
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
installed_risk_tools_type | Array | 安装的风险工具类型列表 | 参考安装的风险工具类型列表说明 |
running_risk_tools_type | Array | 运行的风险工具类型列表 | 参考运行的风险工具类型列表说明 |
安装的风险工具类型
字段 | 适用平台 | 描述 | 备注 |
---|---|---|---|
quick_macro | Android, iOS | 自动点击工具 | |
cydia | Android | cydia | |
agent_app | Android, iOS | 代理工具 | |
more_open | Android | 双开工具 | |
machine_change_tools | Android, iOS | 改机工具 | |
code_receiving_platform | Android | 接码平台 | |
magisk | Android | magisk | |
virtual_app | Android | virtualapp | |
virtual_positioning | Android, iOS | 虚拟定位工具 | |
group_control_software | Android | 群控软件 | |
xposed | Android | xposed | |
game_transmission | Android | 游戏变速器工具 | |
game_modifier | Android | 游戏修改器工具 | |
cloud_simulator | Android | 云模拟器软件 | |
crowdsourcing_app | Android | 众包 app | |
skip_ads | Android | 跳过广告 | |
anti_crash_frame | Android | 防闪框架 | |
capture_tool | Android | 抓包工具 | |
frida | Android | frida | |
cloud_phone | iOS | 云手机 | |
troll_store | iOS | 巨魔商店 | |
root_manager | Android | root manager | |
remote_control | Android | 远程控制 | |
screen_casting_software | Android | 投屏软件 |
运行的风险工具类型
字段 | 适用平台 | 描述 | 备注 |
---|---|---|---|
quick_macro | Android | 自动点击工具 | |
cydia | Android | cydia | |
magisk | Android | magisk | |
test_frame | Android | testframe | |
virtual_app | Android | virtualapp | |
xposed | Android | xposed | |
skip_ads | Android | 跳过广告 | |
frida | Android | frida | |
troll_store | iOS | 巨魔商店 | |
remote_control | Android | 远程控制 | |
screen_casting_software | Android | 投屏软件 |
历史风险标签
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
label | String | 风险标签 | 参考历史风险标签列表 "字段" |
last_time | String | 最近一次发生时间 | 13位时间戳 |
历史风险标签列表
字段 | 类型 | 适用平台 | 描述 | 备注 |
---|---|---|---|---|
abnormal_time | String | Android, iOS, 小程序 | 本机时间异常 | 设备时间与实际时间偏差过大 |
emulator | String | Android, iOS, Web, 小程序,Harmony | 设备为模拟器 | 设备为电脑上安装的模拟器 |
incognito_mode | String | Web | 隐身模式 | |
headless_mode | String | Web,小程序 | 虚拟浏览器 | |
abnormal_useragent | String | Web, 小程序 | UA 异常 | |
debugger_detected | String | Android, iOS, Web,小程序(微信) | 检测到调试器 | SDK 工作期间检测到调试器 |
hook_tool_detected | String | Android, iOS,Web | 检测到改机工具 | |
device_info_tampered | String | Android, iOS,Web | 设备参数被篡改 | 检测到设备信息被篡改 |
group_control | String | Android, iOS | 群控 | 使用云手机、群控设备 |
no_sim | String | Android,Harmony,iOS | 未插sim卡 | 设备未插手机卡 |
abnormal_device_attr | String | iOS, Web, 小程序 | 设备参数异常 | 哈希校验异常,某些字段命中特殊值 |
script_tempered | String | Web | 脚本被篡改 | |
virtual_machine | String | Web | 设备为虚拟机 | 检测到设备为虚拟机 |
local_debug | String | Web | 本地调试 | 检测到本地调试 |
adb_link | String | Android | ADB 调试 | 移动设备连接 PC 端,处于 ADB 调试状态 |
repackaged | String | Android, iOS | 二次打包 | |
proxy_detected | String | Android, Harmony,iOS, 小程序(微信) | 使用代理 | |
root | String | Android | root | |
jail_break | String | iOS | 越狱 | |
vpn_detected | String | Android, iOS,Harmony | 使用 VPN | |
replay_attacks | String | Android, Harmony,iOS, Web, 小程序 | 重放攻击 | 同一份设备数据被多次上报 |
cookie_tempered | String | Android,Harmony, iOS, Web, 小程序 | Cookie 被篡改 | 客户端设备指纹的 Cookie 被篡改 |
crawler | String | Web | 爬虫 | |
malicious_crx | String | Web | 恶意扩展程序 | |
debug_tool | String | Web | 调试器工具 | |
app_multiple_running | String | Android,iOS | 应用多开 | |
sys_multiple_running | String | Android | 系统多开 | |
gps_fake | String | Android, iOS, 小程序(微信) | 虚拟定位 | |
risk_rom | String | Android | 疑似风险ROM | 非原生出厂设备的ROM |
camera_fake | String | Android, iOS | 摄像头劫持 | |
suspected_reset | String | Android,iOS | 疑似重置 | |
short_uptime | String | Android,iOS,Harmony | 开机时间过短 | |
screen_sharing | String | Android,iOS | 屏幕共享 | |
cloud_phone | String | Android,iOS, 小程序(微信) | 云手机 | |
offline_attack | String | Web | 脱机攻击 | |
anti_association_browser | String | Web | 防关联浏览器 | |
device_call | String | Android,iOS,Harmony | 通话状态 |
状态码
状态码 | 建议处理方式 |
---|---|
200 | |
306 | 无可用流量,请联系TD运营 |
500 | 应用异常,可用性保留错误码,量小无需处理 |
512 | 服务未购买,请联系TD运营 |
513 | 流量被禁用,请联系TD运营 |
514 | 服务已过期,请联系TD运营 |
515 | 流量不足,请联系TD运营 |
9150 | 调错环境,请检查调用站点 |
9151 | 认证失败,请检查认证参数 |
9152 | 服务异常,可用性保留错误码,量小无需处理 |
9153 | 内部错误,可用性保留错误码,可能被攻击 |
9154 | SDK未初始化,请检查集成注意事项 |
9155 | 重放攻击,请标记 |
9156 | 文件缺失,可用性保留错误码,可能是集成问题 |
9157 | 超时,建议重试 |
9158 | blackBox 伪造,请标记 |
9159 | blackBox 缺失,请检查业务代码 |
9160 | 调错环境,请检查生产和测试环境是否正确 |
9161 | blackBox 过期,请检查APP是否进行缓存 |
9162 | 媒体类型不支持 |
9163 | 调错环境,地址填写错误 |
响应示例
{
"device_risk_score": 4,
"code": 200,
"channel": "apitest",
"device_risk_label": [
"adb_link"
],
"device_risk_tools": {
"running_risk_tools_type": [],
"installed_risk_tools_type": []
},
"device_detail": {
"app_version": "5.0.0",
"language": "zh",
"installed_packages": "[{\"package\":\"cn.tongdun.mobrisk.demo\",\"name\":\"-\"}]",
"mcc": "",
"wifi_ip": "",
"device_svn": "20",
"available_storage": 109139550208,
"cpu_type": "",
"dns_address": "",
"host": "cn-west-hcd-5a-ad305db651716345895703-78bb978c87-7thzf",
"model": "TAS-AL00",
"brand": "HUAWEI",
"hardware": "kirin990",
"longitude": 0.0,
"cell_ip": "",
"ip": "10.57.30.10",
"screen_resolution": "1080x2340",
"cpu_hardware": "",
"charge_state": "full",
"up_time": 110874673,
"audio_mode": 0,
"aid": "00000000-0000-0000-0000-000000000000",
"startup_time": 1745295692850,
"bssid": "",
"latitude": 0.0,
"running_packages": "cn.tongdun.mobrisk.demo",
"proxy_info": "",
"device_name": "HWTAS",
"total_memory": 7925583872,
"vpn_true_ip": "",
"ipv6": "",
"system_version": "12",
"baseband_version": "21C20B715S000C000",
"fp_version": "5.0.0",
"country_iso": "cn,-",
"current_time": 1745406567523,
"product": "TAS-AL00",
"mnc": "",
"sim_operator": "中国电信,-",
"battery_level": 100,
"vpn_ip": "",
"api_version": "31",
"time_zone": "UTC+08:00",
"sign_md5": "03ce925f76ceb40e1c2ed8bfe3fcdd0c480a7ba8689ff814c601edfbf79e339e",
"screen_brightness": 31,
"carrier": "-,-",
"package_name": "cn.tongdun.mobrisk.demo",
"available_memory": 4362240000,
"total_storage": 117555855360,
"android_id": "9223e63cc64ba3ed",
"network_type": "wifi"
},
"message": "success",
"device_os": "Android",
"device_history_risk_label": [
{
"last_time": "1745312268033",
"label": "device_info_tampered"
},
{
"last_time": "1744612104302",
"label": "debugger_detected"
},
{
"last_time": "1743389182833",
"label": "abnormal_time"
},
{
"last_time": "1739946217228",
"label": "short_uptime"
},
{
"last_time": "1745464165274",
"label": "adb_link"
},
{
"last_time": "1741937366712",
"label": "replay_attacks"
}
],
"anonymous_id": "Iop9ffi1Pvs7N39968k617537Q3GK8TJ39fe63d7b78e0361",
"sequence_id": "1745476264739000X0497006B4905617"
}