设备信息查询

API 接口说明

接口方式

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx∂ner_key=xxxPOSTapplication/jsonJSONUTF-8
认证参数
字段类型含义建议备注
partner_codeString合作方标识必须由 TD 分配
partner_keyString合作方密钥必须由 TD 分配

请求参数

字段类型含义建议备注
black_boxString用来获取设备信息的凭证必须通过 SDK 获取
behaviorString客户端行为采集SDK collect 方法 返回的行为采集数据payload非必须通过 SDK 获取

请求示例

JSON

{
  "black_box": "aGPH1658920283672ropYaFxT7",
  "behavior": "O-vbT-U9ZE2EhrqwgdnwicS0ckarzkkXH4mutX_WrYYujof29benGjFu29hzCxziQjnYGYHmia7QcKNwOfn8Pk57JhMJj4ehl58fFZvyM2VIdm9uVRRYj_A7fiWSbdZPwyVDFlcm1APji3lnb_DTApq9I5c6n3HqRsGLkx_rG_0IXjBRUR3izPjLr-kz7jDqGyoXmrvRfvPIS0TwdjWYa677OHoUr_-2RtAX5ljkknSfMxZQ36rzYN_1RH1ZDyu7akDSg2Pg9AxjYWOaMsxVu6vXWCPwGlbgHyu8h06PO87uoQ3-iYAYr15zcZY-mSsbPi-X8cxH4FlN2b0BoqfoFjWCnCFOR5nRmsEKyNfGsQH-ph9YPUsJVZPNdZZwow_5tWqENMO82yMIc-G2PxZTQXkwQA_9xGtuvsmy6loxYNB_a2qJa3HMHGkoxb7vb1flIaYgCTG2zPRnUWCF7ujBMT6TJq-V0DOtSzmNEBbHfQ7vC4lWGs51shpynfgnJ6bW8FGlrq5veqpFgnGKkJNdONz-8x-TvOs6n17KHDXLVUuXppNdfkeWUY3eRTtrjd_MxYcKN_eFCKn0HezOYURQ9WyP8szoDA-zE3OKj_cUWAwvIKANuV8CHWvWhB6T7PO9y1HlIYJynNqGjwI4jdjIQ6A6HeFqK2wXXNrCbxyCHfz3EeaBDVeWxFcbBnDggd7W"
}

响应参数

字段类型含义响应备注
codeInteger接口状态码存在参考状态码说明
messageString状态信息存在在接口异常状态下会输出具体的异常原因,参考状态码说明
sequence_idString响应唯一码存在用于跟踪每次请求与响应的唯一标识
device_idString设备唯一 ID存在格式固定,长度36位的字符
device_osString设备类型存在Android、iOS、Harmony、Web、wxapp(微信小程序,仅中国节点提供)、myapp(支付宝小程序,仅中国节点提供)、ttapp(字节系小程序,仅中国节点提供)、swapp(百度小程序,仅中国节点提供)、jdapp(京东小程序,仅中国节点提供)、xhsapp(小红书小程序,仅中国节点提供)
channelString渠道存在渠道
device_detailObject设备详情存在参考设备详情说明
ip_locationObject设备对应的 IP 位置信息存在参考 IP 位置信息说明
device_risk_scoreInteger设备风险评分存在范围为 0 - 10000,支持自定义,文档介绍参考风险分
device_risk_labelArray设备风险标签列表存在参考设备风险标签列表说明
device_risk_toolsObject设备风险工具存在参考设备风险工具说明
device_history_risk_labelArray历史风险标签列表存在参考历史风险标签参数说明
vpn_true_ip_locationObject设备对应的VPN 真实 IP 位置信息存在参考VPN 真实 IP位置信息说明
behavior_detailObject行为采集数据详情当传入behavior参数时存在参考下方行为采集信息

设备详情

不同的设备类型对应的设备详情字段不尽相同,下面分别罗列了不同的设备类型对应的设备详情

Android

字段类型含义备注
app_versionStringapp 版本例如 "4.1.6"
system_versionStringAndroid 系统版本例如 "6.0.1"
api_versionStringAndroid API 版本例如 "23"
fp_versionStringSDK 版本例如 "4.1.6"
modelString设备型号例如 "2014811"
brandString设备品牌例如 "Xiaomi"
device_nameString设备名称例如 "HM2014811"
network_typeString网络类型例如 "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown"
ipStringIP 地址例如 "123.157.153.130"
time_zoneString时区例如 "UTC+08:00"
startup_timeLong开机时间例如 1741660150575
up_timeLong开机时长例如 "568273951"
charge_stateString充电状态例如 "charging"、"full"、"not_charging"、"discharging"、"unknown"
battery_levelInteger电量范围为 0 - 100
screen_resolutionString屏幕分辨率宽 x 高,例如:"720x1280"
screen_brightnessInteger屏幕亮度范围为 -1 - 256
total_memoryLong总内存大小字节数
available_memoryLong可用内存大小字节数
total_storageLong总存储大小字节数
available_storageLong可用存储大小字节数
latitudeDouble纬度精确到小数点后 6 位,例如 30.282331
longitudeDouble经度精确到小数点后 6 位,例如 120.011395
accuracyDoubleGPS 水平定位精度(误差半径,单位:m)例如 15.0
gps_locationStringGPS 定位信息例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供)
carrierString移动运营商例如 "中国电信,中国移动"
bssidString无线 MAC 地址例如 "00:1a:8c:a0:69:0a"
wifi_ipString无线 IP 地址例如 "10.57.3.135"
wifi_listStringWiFi 列表例如 "[["38:17:c3:c0:0a:53","Test-Firewall",-49]]"
device_svnString设备软件版本号例如 "07"
hardwareString硬件例如 "qcom"
dns_addressStringDNS 地址例如 "211.137.32.178"
productString产品代号例如 "A37T"
hostStringHOST例如 "qh-miui-ota-offline07"
sim_operatorStringSIM 卡运营商例如 "中国电信,中国移动"
ssidString无线网络名称例如 "xiaoming 的 wifi"
vpn_ipStringVPN IP 地址例如 "10.251.37.229"
cell_ipString本地 IP 地址例如 "10.3.4.9"
current_timeLong当前时间例如 "14816942"
package_nameString应用包名例如 "cn.tongdun. android&3.0.0"
languageString语言例如 "zh"
android_idStringAndroid ID例如 "952b0b1edda80b44"
cpu_hardwareStringCPU 硬件例如 "ARMv7 Processor rev 0 (v7l)"
cpu_typeStringCPU 型号例如 "Qualcomm Technologies"
baseband_versionString基带版本例如 "MPSS.DPM.1.0.c7. 18-00023"
mncString移动网络码例如 "01"
mccString移动国家码例如 "460"
installed_packagesString安装的应用包名例如 "[{\"package\":\"com.miui.screenrecorder\",\"name\":\"-\"},{\"package\":\"com.miui.fm\",\"name\":\"-\"}]"
running_packagesString运行的应用包名例如 "com.xiaomi.shop"
ipv6StringIPv6例如 "fe80::bfd7:21d8:318a:693b"
sign_md5String签名 MD5例如 "6fb472cac420436b773a6325d4cdd7bd"
proxy_infoString代理配置例如 "10.2.3.4:8080"
country_isoString国家代码例如 "cn,cn"
aidStringGoogle个性化广告ID例如 "db13e159-1058-46fc-a4dc-4d2f8197f3af"
vpn_true_ipStringVPN 真实 IP 地址例如 "123.157.153.130"
audio_modeInteger⾳频状态例如“0 -正常模式, 1 -铃声模式 , 2 -通话模式, 3 - 通信模式, 4 - 通话筛选进行中”
first_seen_atLong首次出现的时间例如 1734342323000
app_install_timeLong应用安装时间例如 1743587909428

iOS

字段类型含义备注
app_versionStringapp 版本例如 "1.0.3"
system_versionStringiOS 系统版本例如 "10.2.1"
fp_versionStringSDK 版本例如 "4.1.2"
modelString设备型号例如 "iPhone 6s"
device_nameString设备名称例如 "iPhone"
network_typeString网络类型例如 "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown"
ipStringIP 地址例如 "123.157.153.130"
time_zoneString时区例如 "UTC+08:00"
startup_timeLong开机时间例如 1741660150575
up_timeLong开机时长例如 "568273951"
charge_stateString充电状态例如 "charging"、"unplugged"、"unknown"
battery_levelInteger电量范围为 0 - 100
screen_resolutionString屏幕分辨率宽 x 高,例如:"720x1280"
screen_brightnessInteger屏幕亮度范围为 0 - 100
total_memoryLong总内存大小字节数
total_storageLong总存储大小字节数
available_storageLong可用存储大小字节数
latitudeDouble纬度精确到小数点后 6 位,例如 30.282331
longitudeDouble经度精确到小数点后 6 位,例如 120.011395
accuracyDoubleGPS 水平定位精度(误差半径,单位:m)例如 15.0
gps_locationStringGPS 定位信息例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供)
current_timeLong当前时间例如 "1687680661250"
cell_ipString本地 IP 地址例如 "10.5.2.39"
wifi_ipString无线IP地址例如 "192.168.10.111"
languageString语言例如 "en "
carrierString移动运营商例如 "中国移动"
mncString移动网络码例如 "0"
mccString移动国家码例如 "460"
country_isoString国家代码例如 "cn"
bundle_idStringBundle ID例如 "cn.fraudmetrix. FMDeviceManager"
proxy_infoString代理配置例如 "10.2.3.4:8080"
ssidString无线网络名称例如 "TP-LINK_03FE"
bssidString无线mac地址例如 "80:2f:3e:dd:03:fe"
dns_addressStringDNS 地址例如 "192.168.10.1"
vpn_ipStringVPN IP 地址例如 "10.32.3.98"
ipv6StringIPv6例如 "fe80::bfd7:21d8:318a:693b"
idfaString广告追踪标示符例如 "5D26C201-7FEF-44A6-B57A-1D10E2E2EC63"
idfvString厂商追踪标示符例如 "C767FCBE-6135-4F23-82EB-BBF35E493CDF"
issue_regionString设备发行地区例如 "CH/A"
vpn_true_ipStringVPN 真实 IP 地址例如 "123.157.153.130"
microphone_use_stateInteger麦克风状态例如-1:⽆可⽤⻨克⻛,0:未处于通话状态,1:处于通话状态
first_seen_atLong首次出现的时间例如 1734342323000
app_install_timeLong应用安装时间例如 1743587909428

Harmony

字段类型含义备注
fp_versionStringSDK 版本例如 "1.0.2"
screen_resolutionString屏幕分辨率例如 "1344x2772"
current_timeLong当前时间例如 1711594081876
startup_timeLong开机时间例如 1741660150575
up_timeLong运行时间例如 3503141
time_zoneString时区例如 UTC+08:00
languageString语言例如 "zh-Hans"
charge_stateString充电状态例如 "unknown"、"charging"、"unplugged、"unplugged"、"full"
battery_levelInteger电量例如 20
network_typestring网络类型例如 "wifi"
total_storageLong存储大小例如 243041042432
available_storageLong可用存储大小例如 231078236160
cell_ipString本地 IP 地址例如 "10.24.207.224"
wifi_ipString无线 IP 地址例如 "192.168.101.38"
vpn_ipStringVPN IP 地址例如 "198.18.0.1"
proxy_infostring全局代理信息例如 "10.57.241.80:8888"
device_typeString设备类型例如 "phone"
brandString设备品牌例如 "HUAWEI"
market_nameString市场名称例如 "HUAWEI Mate 40 Pro"
modelString型号例如 "NON-AN00"
hardwareString硬件例如 "HN1NOAHM"
serial_noString设备序列号例如 "05b37354f0dd7f2e"
system_versionString系统版本例如 "2.1.6.6(Beta2)"
api_versionStringAPI版本例如 "11"
udidStringudid例如 "default"
package_namestring应用包名例如 "com.example.harmonyosdemo"
app_versionstringapp 版本例如 "1.0.1"
sign_md5string签名 MD5例如 "8CC29B99116E11A24A7762539327BB566D65773CB64C1521D68E67316DE1923F"
country_isostring国家代码例如 "cn,-"
sim_operatorstringSIM 卡运营商例如 "中国移动,-"
latitudedouble纬度取值范围为-90到90,保留6位小数点
longitudedouble经度取值范围为-180到180,保留6位小数点
ipStringIP 地址223.104.160.62
audio_modeInteger音频状态例如"0-默认音频场景,1-响铃模式,2-电话模式,3-语音聊天模式"
first_seen_atLong首次出现的时间例如 1734342323000
app_install_timeLong应用安装时间例如 1743587909428

Web

字段类型含义备注
browser_nameString浏览器名称例如 "Chrome"
browser_versionString浏览器版本例如 "56.0.2924.87"
fp_versionStringSDK 版本例如 "3.8.5"
user_agentString浏览器 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"
urlStringURL例如 "file:///Users/td/Documents/td/fp/demo_web.html"
device_typeString设备类型例如 "Mac"
osString设备操作系统例如 "Mac OS"
ipStringIP 地址例如 "123.157.153.130"
time_zoneString时区例如 "UTC+08:00"
screen_resolutionString屏幕分辨率宽 x 高,例如:"720x1280"
languageString语言例如 "zh-CN"
refererString请求来源例如:"http://10.57.30.164:8088/"
canvasString帆布指纹例如 "c8a8455d02d7cec9edbe980b6b9e0ff8"
current_timeLong当前时间例如 "1687680661250"
vpn_true_ipStringVPN 真实 IP 地址例如 "123.157.153.130"
latitudeDouble纬度精确到小数点后 6 位,例如 30.2823
longitudeDouble经度精确到小数点后 6 位,例如 120.0113
gps_locationStringGPS 定位信息例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供)
first_seen_atLong首次出现的时间例如 1734342323000

微信/支付宝/字节/百度/京东小程序(仅中国节点提供)

字段类型含义备注
brandString品牌例如 "iPhone"
browserString浏览器名称例如 "MicroMessenger"
browser_typeString浏览器类型例如 "Normal"
font_size_settingString字体大小例如 "23.799999237060547"(京东小程序无该字段)
languageString语言例如 "zh_CN"
modelString型号例如 "iPhone 11"
network_typeString网络类型例如 "wifi"
osString客户端系统例如 "IOS"
screen_brightnessString屏幕亮度例如 "0.717011570930481"
screen_widthString屏幕宽度例如 "414"
screen_heightString屏幕高度例如 "896"
sdk_versionString客户端基础库版本例如 "2.30.2"
fp_versionStringSDK 版本例如 "3.8.5"
smart_idString设备智能 ID例如 "s_bad1549e79b28f8200bdaacb8bc902d0"
systemString操作系统版本例如 "iOS 14.0"
user_agentStringuserAgent例如 "Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.33(0x18002125) NetType/WIFI Language/zh_CN"
versionString应用版本号例如 "8.0.33"
platformString客户端平台例如 "ios"
ipStringIP 地址例如 "112.82.210.140"
current_timeLong当前时间例如 "1687680661250"
latitudeDouble经度精确到小数点后 6 位,例如 30.2823 (仅微信小程序输出)
longitudeDouble纬度精确到小数点后 6 位,例如 120.0113(仅微信小程序输出)
gps_locationStringGPS 定位信息例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供)
first_seen_atLong首次出现的时间例如 1734342323000

IP位置信息

字段类型含义备注
continentString大洲例如 "North America"
countryString国家例如 "United States"
country_idString国家代码例如 "US"
regionString省/州/地区例如 "Virginia"
cityString城市例如 "Ashburn"
accuracy_radiusDoubleGPS 水平定位精度(误差半径,单位:m)例如 35.6001
latitudeDoubleIP 纬度例如 30.384272
longitudeDoubleIP 经度例如 119.987002

设备风险标签

字段类型适用平台描述备注
abnormal_timeStringAndroid, iOS, Web,小程序本机时间异常设备时间与实际时间偏差过大
emulatorStringAndroid, iOS, Web, 小程序,Harmony设备为模拟器设备为电脑上安装的模拟器
incognito_modeStringWeb隐身模式
headless_modeStringWeb,小程序虚拟浏览器
abnormal_useragentStringWeb, 小程序UA 异常
debugger_detectedStringAndroid, iOS, Web,小程序(微信)检测到调试器检测到程序处于调试状态
hook_tool_detectedStringAndroid, iOS,Web检测到改机工具
device_info_tamperedStringAndroid, iOS,Web,小程序设备参数被篡改检测到设备信息被篡改
group_controlStringAndroid, iOS群控使用云手机、群控设备
no_simStringAndroid,Harmony,iOS未插sim卡设备未插手机卡
abnormal_device_attrStringiOS, Web, 小程序设备参数异常哈希校验异常,某些字段命中特殊值
script_temperedStringWeb脚本被篡改
virtual_machineStringWeb设备为虚拟机检测到设备为虚拟机
local_debugStringWeb本地调试检测到本地调试
adb_linkStringAndroidADB 调试移动设备连接 PC 端,处于 ADB 调试状态
repackagedStringAndroid, iOS二次打包
proxy_detectedStringAndroid, Harmony,iOS, 小程序(微信、支付宝)使用代理
rootStringAndroidroot
jail_breakStringiOS越狱
vpn_detectedStringAndroid, iOS,Web,Harmony使用 VPN
replay_attacksStringAndroid, Harmony,iOS, Web, 小程序重放攻击同一份设备数据被多次上报
cookie_temperedStringAndroid,Harmony, iOS, Web, 小程序Cookie 被篡改客户端设备指纹的 Cookie 被篡改
crawlerStringWeb,小程序(微信)爬虫
malicious_crxStringWeb恶意扩展程序
debug_toolStringWeb调试器工具
app_multiple_runningStringAndroid, iOS应用多开
sys_multiple_runningStringAndroid系统多开
gps_fakeStringAndroid, iOS, 小程序(微信)虚拟定位
risk_romStringAndroid疑似风险ROM非原生出厂设备的ROM
camera_fakeStringAndroid, iOS摄像头劫持
suspected_resetStringAndroid,iOS疑似重置
short_uptimeStringAndroid,iOS,Harmony开机时间过短
screen_sharingStringAndroid,iOS,Harmony, 小程序(微信)屏幕共享
cloud_phoneStringAndroid,iOS, 小程序(微信)云手机
offline_attackStringWeb,Android,iOS,小程序(微信)脱机攻击
anti_association_browserStringWeb防关联浏览器
device_callStringAndroid,iOS,Harmony通话状态

设备风险工具

字段类型含义备注
installed_risk_tools_typeArray安装的风险工具类型列表参考安装的风险工具类型列表说明
running_risk_tools_typeArray运行的风险工具类型列表参考运行的风险工具类型列表说明

安装的风险工具类型

字段适用平台描述备注
quick_macroAndroid, iOS自动点击工具
cydiaAndroid, iOScydia
agent_appAndroid, iOS代理工具
more_openAndroid双开工具
machine_change_toolsAndroid, iOS改机工具
code_receiving_platformAndroid接码平台
magiskAndroidmagisk
virtual_appAndroidvirtualapp
virtual_positioningAndroid, iOS虚拟定位工具
group_control_softwareAndroid群控软件
xposedAndroidxposed
game_transmissionAndroid游戏变速器工具
game_modifierAndroid, iOS游戏修改器工具
cloud_simulatorAndroid云模拟器软件
crowdsourcing_appAndroid众包 app
skip_adsAndroid跳过广告
anti_crash_frameAndroid防闪框架
capture_toolAndroid抓包工具
fridaAndroid, iOSfrida
cloud_phoneiOS云手机
troll_storeiOS巨魔商店
root_managerAndroid, iOSroot manager
remote_controlAndroid远程控制
screen_casting_softwareAndroid投屏软件
face_spoofingAndroidface spoofing

运行的风险工具类型

字段适用平台描述备注
quick_macroAndroid,iOS自动点击工具
machine_change_toolsiOS改机工具
cydiaAndroidcydia
magiskAndroidmagisk
test_frameAndroidtestframe
virtual_appAndroidvirtualapp
xposedAndroidxposed
skip_adsAndroid跳过广告
fridaAndroid,iOSfrida
troll_storeiOS巨魔商店
remote_controlAndroid远程控制
screen_casting_softwareAndroid投屏软件

历史风险标签

字段类型含义备注
labelString风险标签参考历史风险标签列表 "字段"
last_timeString最近一次发生时间13位时间戳

历史风险标签列表

字段类型适用平台描述备注
abnormal_timeStringAndroid, iOS, 小程序本机时间异常设备时间与实际时间偏差过大
emulatorStringAndroid, iOS, Web, 小程序,Harmony设备为模拟器设备为电脑上安装的模拟器
incognito_modeStringWeb隐身模式
headless_modeStringWeb,小程序虚拟浏览器
abnormal_useragentStringWeb, 小程序UA 异常
debugger_detectedStringAndroid, iOS, Web,小程序(微信)检测到调试器附加检测到程序处于调试状态
hook_tool_detectedStringAndroid, iOS,Web检测到改机工具
device_info_tamperedStringAndroid, iOS,Web, 小程序设备参数被篡改检测到设备信息被篡改
group_controlStringAndroid, iOS群控使用云手机、群控设备
no_simStringAndroid,Harmony,iOS未插sim卡设备未插手机卡
abnormal_device_attrStringiOS, Web, 小程序设备参数异常哈希校验异常,某些字段命中特殊值
script_temperedStringWeb脚本被篡改
virtual_machineStringWeb设备为虚拟机检测到设备为虚拟机
local_debugStringWeb本地调试检测到本地调试
adb_linkStringAndroidADB 调试移动设备连接 PC 端,处于 ADB 调试状态
repackagedStringAndroid, iOS二次打包
proxy_detectedStringAndroid, Harmony,iOS, 小程序(微信、支付宝)使用代理
rootStringAndroidroot
jail_breakStringiOS越狱
vpn_detectedStringAndroid, iOS,Harmony使用 VPN
replay_attacksStringAndroid, Harmony,iOS, Web, 小程序重放攻击同一份设备数据被多次上报
cookie_temperedStringAndroid,Harmony, iOS, Web, 小程序Cookie 被篡改客户端设备指纹的 Cookie 被篡改
crawlerStringWeb,小程序(微信)爬虫
malicious_crxStringWeb恶意扩展程序
debug_toolStringWeb调试器工具
app_multiple_runningStringAndroid,iOS应用多开
sys_multiple_runningStringAndroid系统多开
gps_fakeStringAndroid, iOS, 小程序(微信)虚拟定位
risk_romStringAndroid疑似风险ROM非原生出厂设备的ROM
camera_fakeStringAndroid, iOS摄像头劫持
suspected_resetStringAndroid,iOS疑似重置
short_uptimeStringAndroid,iOS,Harmony开机时间过短
screen_sharingStringAndroid,iOS屏幕共享
cloud_phoneStringAndroid,iOS, 小程序(微信)云手机
offline_attackStringWeb,Android,iOS,小程序(微信)脱机攻击
anti_association_browserStringWeb防关联浏览器
device_callStringAndroid,iOS,Harmony通话状态

VPN 真实 IP位置信息

字段类型含义备注
continentString大洲例如 "North America"
countryString国家例如 "United States"
country_idString国家代码例如 "US"
regionString省/州/地区例如 "Virginia"
cityString城市例如 "Ashburn"
accuracy_radiusDoubleGPS 水平定位精度(误差半径,单位:m)例如 35.6001
latitudeDoubleIP 纬度例如 30.384272
longitudeDoubleIP 经度例如 119.987002

行为采集信息

字段所属种类类型含义平台
scale_rage_actions_countAnomalyint以秒为计算单元,缩放事件速度超过某个值的次数,例如当前计算单元速度超过 5个缩放事件 / 每秒,则次数+1iOS、Android、Flutter
scroll_rage_actions_countAnomalyint以秒为计算单元,滚动事件速度超过某个值的次数,例如当前计算单元速度超过 5个缩放事件 / 每秒,则次数+1iOS、Android、Flutter
swipe_rage_actions_countAnomalyint以秒为计算单元,滑动事件速度超过某个值的次数,例如当前计算单元速度超过 5个缩放事件 / 每秒,则次数+1iOS、Android、Flutter
text_input_rage_actions_countAnomalyint以秒为计算单元,文字输入事件速度超过某个值的次数,例如当前计算单元速度超过 5个缩放事件 / 每秒,则次数+1iOS、Android、Flutter
touch_rage_actions_countAnomalyint以秒为计算单元,触摸事件速度超过某个值的次数,例如当前计算单元速度超过 5个缩放事件 / 每秒,则次数+1iOS、Android、Flutter、Web
keyboard_rage_actions_countAnomalyint以秒为计算单元,键盘事件速度超过某个值的次数,例如当前计算单元速度超过 5个键盘事件 / 每秒,则次数+1Web
mouse_rage_actions_countAnomalyint以秒为计算单元,鼠标事件速度超过某个值的次数,例如当前计算单元速度超过 5个鼠标事件 / 每秒,则次数+1Web
click_rage_actions_countAnomalyint以秒为计算单元,点击事件速度超过某个值的次数,例如当前计算单元速度超过 5个点击事件 / 每秒,则次数+1Web
scale_total_events_countFingerint缩放事件总个数iOS、Android、Flutter
scroll_path_lengthFingerstring(float)滚动事件总距离,单位:像素,示例:"100.0"iOS、Android、Flutter
swipe_path_lengthFingerstring(float)滑动事件总距离,单位:像素,示例:"100.0"iOS、Android、Flutter
swipe_total_events_countFingerint滑动事件总个数iOS、Android、Flutter
text_input_total_events_countFingerint文字输入事件总个数iOS、Android、Flutter
touch_total_events_countFingerint触摸事件总个数iOS、Android、Flutter、Web
scroll_total_events_countFingerint滚动事件总个数iOS、Android、Flutter、Web
touch_actions_speedFingerstring(float)触摸事件速度,单位:个 / s,示例:"100.0"iOS、Android、Flutter、Web
click_total_events_countFingerint点击事件总个数Web
mouse_moving_path_lengthFingerstring(float)鼠标滑动事件总距离,单位:像素,示例:"100.0"Web
mouse_moving_speedFingerstring(float)鼠标移动速度,单位:像素 / s,示例:"100.0"Web
mouse_hover_total_events_countFingerint悬停事件总个数,鼠标静止时间超过0.5s,即触发悬停事件Web
mouse_hover_time_spent_totalFingerstring(float)悬停事件总时间,鼠标静止时间超过0.5s,即触发悬停事件,单位:s,示例:"100.0"Web
application_as_background_countInteractionsint应用进入后台的次数iOS、Android、Flutter
application_as_foreground_countInteractionsint应用进入前台的次数iOS、Android、Flutter
application_navi_countInteractionsint应用界面切换的次数iOS、Android、Flutter
client_activity_session_time_spent_totalInteractionsstring(float)应用在前台的时间,单位:秒,示例:"100.0"iOS、Android、Flutter
client_interactions_time_spent_totalInteractionsstring(float)应用内输入框光标聚焦时间之和,单位:秒,示例:"100.0"iOS、Android、Flutter
client_interactions_tracked_events_countInteractionsint应用内输入框光标聚焦期间内触发的事件个数,事件类型包括touch,scroll,screenEdgePan,swipe,textInputiOS、Android、Flutter
text_input_text_removed_all_countInteractionsint输入事件中,全删输入事件的个数,要求删除前,文字长度大于1iOS、Android、Flutter
input_delete_actions_countInteractionsint输入事件中,以"通常"方式删除字母,删除操作输入事件的个数(每个事件删除一个字符)。iOS、Android、Flutter、Web
input_insert_actions_countInteractionsint输入事件中,以"通常"方式插入字母,插入操作输入事件的个数(每个事件插入一个字符)。iOS、Android、Flutter、Web
input_cut_actions_countInteractionsint输入事件中,剪切操作输入事件的个数Web
input_copy_actions_countInteractionsint输入事件中,复制操作输入事件的个数Web
input_paste_actions_countInteractionsint输入事件中,粘贴操作输入事件的个数iOS、Android、Flutter、Web
application_navi_infoInteractionsstring应用界面切换的信息,包括界面名称、停留时间, 示例:"Main0,2.1211,SignIn0,25.7295"iOS、Android、Flutter、Web
accelerometer_g_rage_actions_countSportint按时间排序加速度计数据,取固定个数的加速度计数据,计算这些数据的g值方差是否大于某个固定值,如果大于,则次数+1iOS、Android、Flutter
gyroscope_x_rage_actions_countSportint按时间排序陀螺仪数据,取固定个数的陀螺仪数据,计算这些数据的x值方差是否大于某个固定值,如果大于,则次数+1iOS、Android、Flutter
gyroscope_y_rage_actions_countSportint按时间排序陀螺仪数据,取固定个数的陀螺仪数据,计算这些数据的y值方差是否大于某个固定值,如果大于,则次数+1iOS、Android、Flutter
gyroscope_z_rage_actions_countSportint按时间排序陀螺仪数据,取固定个数的陀螺仪数据,计算这些数据的z值方差是否大于某个固定值,如果大于,则次数+1iOS、Android、Flutter
orientation_total_events_countSportint设备旋转方向发生变化的次数iOS、Android、Flutter
orientation_rage_actions_countSportint以分钟为计算单元,设备旋转事件速度超过某个值的次数,例如当前计算单元速度超过 5个设备旋转事件 / 每分钟,则次数+1iOS、Android、Flutter
text_input_chars_except_num_and_letters_countTypingint输入事件中,当字段中输入任何其他字符(包括符号、标点、标记和分隔符)或每次粘贴的字符数量超过1个时(包括从日历选择器中选择日期)的字符个数iOS、Android、Flutter
text_input_letters_countTypingint输入事件中,在字段填写过程中以"通常"方式输入字母的文本输入事件个数(1个输入事件输入1个字母)iOS、Android、Flutter
text_input_numbers_countTypingint输入事件中,在字段填写过程中以"通常"方式输入数字的文本输入事件个数(1个输入事件输入1个数字)iOS、Android、Flutter
text_input_speedTypingint文字输入速度,单位: 字 / siOS、Android、Flutter
input_start_with_lower_countTypingint输入事件中,以小写字母开头输入事件的个数iOS、Android、Flutter、Web
input_start_with_number_countTypingint输入事件中,以数字开头输入事件的个数iOS、Android、Flutter、Web
input_start_with_upper_countTypingint输入事件中,以大写字母开头输入事件的个数iOS、Android、Flutter、Web
keyboard_letter_keys_pressed_countTypingint键盘事件中,按下字母事件的个数Web
keyboard_total_keys_pressed_countTypingint键盘按下事件总个数Web
keyboard_meta_key_pressed_countTypingint键盘事件中,按下meta键事件的个数Web
keyboard_number_keys_pressed_countTypingint键盘事件中,按下数字键事件的个数Web
keyboard_backspace_key_pressed_countTypingint键盘事件中,按下backspace键事件的个数Web
keyboard_shift_key_pressed_countTypingint键盘事件中,按下shift键事件的个数Web
keyboard_ctrl_key_pressed_countTypingint键盘事件中,按下ctrl键事件的个数Web
keyboard_delete_key_pressed_countTypingint键盘事件中,按下delete键事件的个数Web
keyboard_space_key_pressed_countTypingint键盘事件中,按下space键事件的个数Web
keyboard_symbol_key_pressed_countTypingint键盘事件中,按下符号键事件的个数Web
keyboard_tab_key_pressed_countTypingint键盘事件中,按下table键事件的个数Web
keyboard_alt_key_pressed_countTypingint键盘事件中,按下alt键事件的个数Web
keyboard_cut_keys_pressed_countTypingint键盘事件中,按下"ctrl + x"组合键 的 事件个数Web
keyboard_copy_keys_pressed_countTypingint键盘事件中,按下"ctrl + c"组合键 的 事件个数Web
keyboard_paste_keys_pressed_countTypingint键盘事件中,按下"ctrl + v"组合键 的 事件个数Web
keyboard_shift_delete_actions_countTypingint键盘事件中,按下"shift + delete"组合键 的 事件个数Web
keyboard_ctrl_alt_delete_actions_countTypingint键盘事件中,按下"ctrl + alt + delete"组合键 的 事件个数Web
keyboard_text_shift_key_pressed_countTypingint键盘事件中,按下shift键进行大写字母和特殊符号输入的事件个数;Web
keyboard_typing_speedTypingint键盘事件速度,单位:个 / sWeb
keyboard_is_trusted_key_countTypingint键盘事件中,应用程序流程中可信输入的个数,即event.isTrusted == true 的事件总个数Web
input_from_inside_countTypingint用户与输入框交互时在字段内输入某个值的总次数(位置 > 1 且 < 字符串长度)Web
input_from_end_countTypingint用户在第一次与输入框交互时,在字符串末尾输入某些值的总次数Web
input_from_beginning_countTypingint用户与输入框交互时从字段第一个位置开始输入的次数Web
touch_prop_force_maxTypingstring(float)触摸事件,最大压力值,示例:"0.8"Web
touch_prop_force_avgTypingstring(float)触摸事件,平均压力值,示例:"0.5"Web
touch_prop_force_minTypingstring(float)触摸事件,最小压力值,示例:"0.2"Web
text_input_countTypingint全部输入事件总字符个数iOS、Android、Flutter、Web

状态码

状态码建议处理方式是否计费
200
306无可用流量,请联系TD运营
500应用异常,可用性保留错误码,量小无需处理
512服务未购买,请联系TD运营
513流量被禁用,请联系TD运营
514服务已过期,请联系TD运营
515流量不足,请联系TD运营
9150调错环境,请检查调用站点
9151认证失败,请检查认证参数
9152服务异常,可用性保留错误码,量小无需处理
9153blackBox 非法,请标记
9154SDK未初始化,请检查集成注意事项
9155重放攻击,请标记
9156文件缺失,可用性保留错误码,可能是集成问题
9157超时,建议重试
9158blackBox 伪造,请标记
9159blackBox 缺失,请检查业务代码
9160调错环境,请检查生产和测试环境是否正确
9161blackBox 过期,请检查APP是否进行缓存
9162媒体类型不支持
9163调错环境,地址填写错误
9164SDK 初始化异常,请检查 SDK 返回的 apiStatus

响应示例

{
    "device_risk_score": 8,
    "code": 200,
    "device_id": "c1nG3793-Z5a0-p97J-180N-0nC1DYQh12Yj",
    "channel": "apitest",
    "device_risk_label": [
        "no_sim",
        "adb_link"
    ],
    "device_risk_tools": {
        "running_risk_tools_type": [],
        "installed_risk_tools_type": []
    },
    "device_detail": {
        "app_version": "4.8.0.2",
        "language": "zh",
        "installed_packages": "[{\"package\":\"cn.tongdun.mobrisk.demo\",\"name\":\"-\"}]",
        "mcc": "",
        "gps_location": {
            "address": "",
            "province": "",
            "city": "",
            "region": "",
            "township": ""
        },
        "wifi_ip": "",
        "device_svn": "20",
        "available_storage": 137275531264,
        "cpu_type": "",
        "dns_address": "",
        "host": "cn-west-hcd-5a-acab910141717386065435-588c6955d6-48x72",
        "model": "OXF-AN10",
        "brand": "HONOR",
        "hardware": "kirin990",
        "longitude": 0,
        "cell_ip": "",
        "ip": "183.129.232.236",
        "screen_resolution": "1080x2400",
        "cpu_hardware": "",
        "charge_state": "charging",
        "up_time": 82841770,
        "audio_mode": 0,
        "aid": "",
        "startup_time": 1757472801887,
        "bssid": "",
        "latitude": 0,
        "running_packages": "cn.tongdun.mobrisk.demo",
        "proxy_info": "",
        "device_name": "HWOXF",
        "total_memory": 7868047360,
        "vpn_true_ip": "",
        "ipv6": "",
        "system_version": "12",
        "baseband_version": "21C93B398S000C000",
        "fp_version": "4.8.0.2",
        "country_iso": "cn,-",
        "current_time": 1757555643657,
        "product": "OXF-AN10",
        "mnc": "",
        "sim_operator": "-,-",
        "battery_level": 67,
        "first_seen_at": 1735097180012,
        "vpn_ip": "",
        "api_version": "31",
        "time_zone": "UTC+08:00",
        "sign_md5": "03ce925f76ceb40e1c2ed8bfe3fcdd0c480a7ba8689ff814c601edfbf79e339e",
        "screen_brightness": 71,
        "carrier": "-,-",
        "app_install_time": 1757482908393,
        "package_name": "cn.tongdun.mobrisk.demo",
        "available_memory": 3286253568,
        "total_storage": 245389852672,
        "android_id": "0828e7ca28dae28c",
        "network_type": "wifi",
        "wifi_list": "[{\"wifi_bssid\":\"28:6c:07:47:c3:bb\",\"wifi_ssid\":\"ZD_5G\",\"wifi_level\":-54},{\"wifi_bssid\":\"dc:f0:90:33:02:92\",\"wifi_ssid\":\"nunu\",\"wifi_level\":-58},{\"wifi_bssid\":\"e8:ac:23:cb:34:76\",\"wifi_ssid\":\"tdiot\",\"wifi_level\":-69},{\"wifi_bssid\":\"e8:ac:23:cb:34:74\",\"wifi_ssid\":\"TD-Phone\",\"wifi_level\":-69},{\"wifi_bssid\":\"e8:ac:23:cb:34:73\",\"wifi_ssid\":\"TD-GUEST\",\"wifi_level\":-69},{\"wifi_bssid\":\"e8:ac:23:cb:34:72\",\"wifi_ssid\":\"Tongdun\",\"wifi_level\":-69},{\"wifi_bssid\":\"e8:ac:23:cb:34:71\",\"wifi_ssid\":\"TrustDecision\",\"wifi_level\":-69},{\"wifi_bssid\":\"e8:ac:23:cb:34:70\",\"wifi_ssid\":\"Zhongboxin\",\"wifi_level\":-69},{\"wifi_bssid\":\"76:8d:2a:32:71:49\",\"wifi_ssid\":\"608-TDXT\",\"wifi_level\":-75},{\"wifi_bssid\":\"e8:ac:23:ca:89:a2\",\"wifi_ssid\":\"Tongdun\",\"wifi_level\":-91}]",
        "accuracy": 15.0,
        "ssid": "ZD_5G",
        "oaid": "f976d3ee-7168-4f06-a7a5-4dea08a9662a"
    },
    "behavior_detail": {
        "anomaly": {
            "scale_rage_actions_count": 0,
            "scroll_rage_actions_count": 0,
            "swipe_rage_actions_count": 0,
            "text_input_rage_actions_count": 1,
            "touch_rage_actions_count": 0
        },
        "finger": {
            "scale_total_events_count": 0,
            "scroll_path_length": 0,
            "scroll_total_events_count": 0,
            "swipe_path_length": 0,
            "swipe_total_events_count": 0,
            "text_input_total_events_count": 21,
            "touch_actions_speed": 0,
            "touch_total_events_count": 0
        },
        "interactions": {
            "application_as_background_count": 0,
            "application_as_foreground_count": 0,
            "application_navi_count": 0,
            "application_navi_info": "SignIn0,25.7295",
            "client_activity_session_time_spent_total": "25.8215",
            "client_interactions_time_spent_total": "9.6349",
            "client_interactions_tracked_events_count": 21,
            "input_delete_actions_count": 0,
            "input_insert_actions_count": 17,
            "input_paste_actions_count": 0,
            "text_input_text_removed_all_count": 1
        },
        "sport": {
            "accelerometer_g_rage_actions_count": 22,
            "gyroscope_x_rage_actions_count": 22,
            "gyroscope_y_rage_actions_count": 22,
            "gyroscope_z_rage_actions_count": 22,
            "orientation_rage_actions_count": 0,
            "orientation_total_events_count": 0
        },
        "typing": {
            "input_start_with_lower_count": 1,
            "input_start_with_number_count": 0,
            "input_start_with_upper_count": 0,
            "text_input_chars_except_num_and_letters_count": 6,
            "text_input_count": 23,
            "text_input_letters_count": 9,
            "text_input_numbers_count": 8,
            "text_input_speed": "2.3871"
        }
    },
    "message": "success",
    "device_os": "Android",
    "ip_location": {
        "continent": "亚洲",
        "country": "中国",
        "city": "杭州市",
        "region": "浙江省",
        "country_id": "CN",
        "latitude": 30.384272,
        "accuracy_radius": 35.6001,
        "longitude": 119.987002
    },
    "vpn_true_ip_location": {
        "continent": "",
        "country": "",
        "city": "",
        "region": "",
        "country_id": "",
        "latitude": 0.0,
        "accuracy_radius": 0.0,
        "longitude": 0.0
    },
    "device_history_risk_label": [
        {
            "last_time": "1749105497989",
            "label": "app_multiple_running"
        },
        {
            "last_time": "1753944006009",
            "label": "vpn_detected"
        },
        {
            "last_time": "1749105497989",
            "label": "camera_fake"
        },
        {
            "last_time": "1757555625652",
            "label": "no_sim"
        },
        {
            "last_time": "1742286486244",
            "label": "short_uptime"
        },
        {
            "last_time": "1757555625652",
            "label": "adb_link"
        },
        {
            "last_time": "1749105497989",
            "label": "gps_fake"
        },
        {
            "last_time": "1746762648790",
            "label": "repackaged"
        },
        {
            "last_time": "1753944006009",
            "label": "device_info_tampered"
        },
        {
            "last_time": "1757498166978",
            "label": "abnormal_time"
        },
        {
            "last_time": "1748338101708",
            "label": "cloud_phone"
        },
        {
            "last_time": "1753944006009",
            "label": "proxy_detected"
        },
        {
            "last_time": "1757498166978",
            "label": "replay_attacks"
        }
    ],
    "sequence_id": "1757555737405256F8BD761B87527878"
}