TrustDecision
API Reference
English
Start typing to search…

设备调用日志

API 接口说明

接口方式

Base URL

API

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

请求参数

字段类型含义建议备注
black_boxString用来获取设备信息的凭证必须通过 SDK 获取

请求示例

{
  "black_box": "aGPH1658920283672ropYaFxT7"
}

响应参数

字段类型含义响应备注
codeInteger接口状态码存在参考状态码说明
messageString状态信息存在在接口异常状态下会输出具体的异常原因，参考状态码说明
sequence_idString响应唯一码存在用于跟踪每次请求与响应的唯一标识
anonymous_idString匿名 ID存在格式固定，长度48位的字符
device_osString设备类型存在Android、iOS、Web
channelString渠道存在渠道
device_detailObject设备详情存在参考设备详情说明
device_risk_scoreInteger设备风险评分存在范围为 0 - 10000，支持自定义，文档介绍参考风险分
device_risk_labelArray设备风险标签列表存在参考设备风险标签列表说明
device_risk_toolsObject设备风险工具存在参考设备风险工具说明
device_history_risk_labelArray历史风险标签列表存在参考历史风险标签参数说明

设备详情

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

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
carrierString移动运营商例如 "中国电信,中国移动"
bssidString无线 MAC 地址例如 "00:1a:8c:a0:69:0a"
wifi_ipString无线 IP 地址例如 "10.57.3.135"
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 - 通话筛选进行中”

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
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"
issue_regionString设备发行地区例如 "CH/A"
vpn_true_ipStringVPN 真实 IP 地址例如 "123.157.153.130"
microphone_use_stateInteger麦克风状态例如-1：⽆可⽤⻨克⻛,0：未处于通话状态,1：处于通话状态

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

设备风险标签

字段类型适用平台描述备注
abnormal_timeStringAndroid, iOS, 小程序本机时间异常设备时间与实际时间偏差过大
emulatorStringAndroid, iOS, Web, 小程序,Harmony设备为模拟器设备为电脑上安装的模拟器
incognito_modeStringWeb隐身模式
headless_modeStringWeb,小程序虚拟浏览器
abnormal_useragentStringWeb, 小程序UA 异常
debugger_detectedStringAndroid, iOS, Web,小程序（微信）检测到调试器SDK 工作期间检测到调试器
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脱机攻击
anti_association_browserStringWeb防关联浏览器
device_callStringAndroid,iOS,Harmony通话状态

设备风险工具

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

安装的风险工具类型

字段适用平台描述备注
quick_macroAndroid, iOS自动点击工具
cydiaAndroidcydia
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游戏修改器工具
cloud_simulatorAndroid云模拟器软件
crowdsourcing_appAndroid众包 app
skip_adsAndroid跳过广告
anti_crash_frameAndroid防闪框架
capture_toolAndroid抓包工具
fridaAndroidfrida
cloud_phoneiOS云手机
troll_storeiOS巨魔商店
root_managerAndroidroot manager
remote_controlAndroid远程控制
screen_casting_softwareAndroid投屏软件

运行的风险工具类型

字段适用平台描述备注
quick_macroAndroid自动点击工具
cydiaAndroidcydia
magiskAndroidmagisk
test_frameAndroidtestframe
virtual_appAndroidvirtualapp
xposedAndroidxposed
skip_adsAndroid跳过广告
fridaAndroidfrida
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,小程序（微信）检测到调试器SDK 工作期间检测到调试器
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脱机攻击
anti_association_browserStringWeb防关联浏览器
device_callStringAndroid,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"
}