TrustDecision
API Reference
中文

DeviceInfo.

Device Information

Data Type: DeviceInfo

ParameterTypeDescriptionRequired/OptionalNotes
device_idStringThe unique ID of the deviceRequiredUnique device ID given by AFD
device_osStringDevice typeRequiredSuch as: Android、iOS、Web
device_detailObjectDevice detailsRequiredRefer to device details explanation
ip_locationObjectIP location information corresponding to the deviceRequiredRefer to explanation of IP location information
device_risk_labelArrayLabel list for device risksConditionally requiredRefer to explanation of device risks label list
device_risk_toolsObjectDevice Risk ToolConditionally requiredRefer to device risk tool explanation

Device details explanation

Different device types correspond to different device details fields. The device details corresponding to different device types are listed below.

Android
ParameterTypeDescriptionNotes
app_versionStringApp versionFor example, "4.1.6"
system_versionStringAndroid versionFor example, "6.0.1"
api_versionStringAndroid API versionFor example, "23"
fp_versionStringSDK versionFor example, "4.1.6"
modelStringDevice modelFor example, "2014811"
brandStringDevice brandFor example, "Xiaomi"
device_nameStringDevice nameFor example, "HM2014811"
network_typeStringNetwork typeFor example, "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown"
ipStringIP addressFor example, "123.157.153.130"
time_zoneStringTime zoneFor example, "UTC+0800"
time_zone_districtStringTime zoneFor example, “Asia/Jakarta”
startup_timeStringStartup timeFor example, "2021-01-01 00:00:00"
up_timeLongUp timeFor example, "568273951"
charge_stateStringCharge stateFor example, "charging"、"full"、"not_charging"、"discharging"、"unknown"
battery_levelIntegerBattery levelRange from 0 to 100
screen_resolutionStringScreen resolutionWidth x Height, for example: "720x1280"
screen_brightnessIntegerScreen brightnessRange from -1 to 256
total_memoryLongTotal memory sizeNumber of bytes
available_memoryLongAvailable memory sizeNumber of bytes
total_storageLongTotal storage sizeNumber of bytes
available_storageLongAvailable storage sizeNumber of bytes
latitudeDoubleLatitudeAccurate to 6 decimal places, for example 30.282331
longitudeDoubleLongitudeAccurate to 6 decimal places, for example 120.011395
gps_locationStringGPS location informationFor example, " {"address": "No. 998, Wenyi West Road, Cangqian Town, Yuhang District, Hangzhou City, Zhejiang Province", "city": "Hangzhou City", "province": "Zhejiang Province", "township": "Cangzhou Qianzhen" }" (only available in China nodes)
carrierStringMobile operatorsFor example "China Telecom, China Mobile"
bssidStringWireless MAC addressFor example, "00:1a:8c:a0:69:0a"
wifi_ipStringWireless IP addressFor example, "10.57.3.135"
device_svnStringDevice software version numberFor example, "07"
hardwareStringHardwareFor example, "qcom"
dns_addressStringDNS addressFor example, "211.137.32.178"
productStringProduct codeFor example, "A37T"
hostStringHOSTFor example, "qh-miui-ota-offline07"
sim_operatorStringSIM card operatorFor example "China Telecom, China Mobile"
ssidStringWireless network nameFor example, "xiaoming 的 wifi"
vpn_ipStringVPN IP addressFor example, "10.251.37.229"
cell_ipStringLocal IP addressFor example, "10.3.4.9"
current_timeLongCurrent timeFor example, "14816942"
package_nameStringApplication package nameFor example, "cn.tongdun. android&3.0.0"
languageStringLanguageFor example, "zh"
android_idStringAndroid IDFor example, "952b0b1edda80b44"
cpu_hardwareStringCPU hardwareFor example, "ARMv7 Processor rev 0 (v7l)"
cpu_typeStringCPU typeFor example, "Qualcomm Technologies"
baseband_versionStringBaseband versionFor example, "MPSS.DPM.1.0.c7. 18-00023"
mncStringMobile network codeFor example, "01"
mccStringMobile country codeFor example, "460"
installed_packagesStringInstalled application package nameFor example, "[{"package":"com.miui.screenrecorder","name":"-"},{"package":"com.miui.fm","name":"-"}]"
running_packagesStringRunning application package nameFor example, "com.xiaomi.shop"
ipv6StringIPv6For example, "fe80::bfd7:21d8:318a:693b"
sign_md5StringSign MD5For example, "6fb472cac420436b773a6325d4cdd7bd"
proxy_infoStringproxy informationFor example, "10.2.3.4:8080"
country_isoStringCountry codeFor example, "cn"
iOS
ParameterTypeDescriptionNotes
app_versionStringapp versionFor example, "1.0.3"
system_versionStringiOS system versionFor example, "10.2.1"
fp_versionStringSDK versionFor example, "4.1.2"
modelStringDevice modelFor example, "iPhone 6s"
device_nameStringDevice nameFor example, "iPhone"
network_typeStringNetwork TypeFor example, "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown"
ipStringIP addressFor example, "123.157.153.130"
time_zoneStringTime zoneFor example, "UTC+0800"
time_zone_districtStringTime zoneFor example, “Asia/Jakarta”
startup_timeStringStartup timeFor example, "2021-01-01 00:00:00"
up_timeLongUp timeFor example, "568273951"
charge_stateStringCharge stateFor example, "charging"、"unplugged"、"unknown"
battery_levelIntegerBattery levelRange from 0 to 100
screen_resolutionStringScreen resolutionWidth x Height, for example: "720x1280"
screen_brightnessIntegerScreen brightnessRange from 0 to 100
total_memoryLongTotal memory sizeNumber of bytes
available_memoryLongAvailable memory sizeNumber of bytes
total_storageLongTotal storage sizeNumber of bytes
available_storageLongAvailable storage sizeNumber of bytes
latitudeDoubleLatitudeAccurate to 6 decimal places, for example 30.282331
longitudeDoubleLongitudeAccurate to 6 decimal places, for example 120.011395
gps_locationStringGPS location informationFor example, " {"address": "No. 998, Wenyi West Road, Cangqian Town, Yuhang District, Hangzhou City, Zhejiang Province", "city": "Hangzhou City", "province": "Zhejiang Province", "township": " Cangqian Town" }" (only available in China nodes)
current_timeLongCurrent timeFor example, "1687680661250"
cell_ipStringLocal IP addressFor example, "10.5.2.39"
wifi_ipStringWireless IP addressFor example, "192.168.10.111"
languageStringLanguageFor example, "en "
carrierStringMobile operatorsFor example "China Mobile"
mncStringMobile network codeFor example, "0"
mccStringMobile country codeFor example, "460"
country_isoStringCountry codeFor example, "cn"
bundle_idStringBundle IDFor example, "cn.fraudmetrix. FMDeviceManager"
proxy_infoStringProxy informationFor example, "10.2.3.4:8080"
ssidStringWireless network nameFor example, "TP-LINK_03FE"
bssidStringWireless mac addressFor example, "80:2f:3e:dd:03:fe"
dns_addressStringDNS addressFor example, "192.168.10.1"
vpn_ipStringVPN IP addressFor example, "10.32.3.98"
ipv6StringIPv6For example, "fe80::bfd7:21d8:318a:693b"
Web
ParameterTypeDescriptionNotes
browser_nameStringBrowser nameFor example, "Chrome"
browser_versionStringBrowser versionFor example, "56.0.2924.87"
fp_versionStringSDK versionFor example, "3.8.5"
user_agentStringBrowser UAFor example, "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"
urlStringURLFor example, "file:///Users/td/Documents/td/fp/demo_web.html"
device_typeStringDevice typeFor example, "Mac"
osStringDevice operating systemFor example, "Mac OS"
ipStringIP addressFor example, "123.157.153.130"
time_zoneStringTime zoneFor example, "UTC+0800"
time_zone_districtStringTime zoneFor example,“Asia/Jakarta”
screen_resolutionStringScreen ResolutionWidth x Height, for example: "720x1280"
languageStringLanguageFor example, "zh-CN"
refererStringRequest sourceFor example,"http://10.57.30.164:8088/"
canvasStringCanvas fingerprintFor example, "c8a8455d02d7cec9edbe980b6b9e0ff8"
current_timeLongCurrent timeFor example, "1687680661250"

Explanation of IP location information

ParameterTypeDescriptionNotes
continentStringContinentFor example, "North America"
countryStringCountryFor example, "United States"
country_idStringCountry idFor example, "US"
regionStringProvince/State/RegionFor example, "Virginia"
cityStringCityFor example, "Ashburn"

Explanation of device risks label list

ParameterTypeAcceptable platformDescriptionNotes
abnormal_timeStringAndroid, iOS, Mini ProgramAbnormal local timeThe device time deviates too much from the actual time
emulatorStringAndroid, iOS, Web, Mini ProgramDevice is an emulatorThe device is an iOS simulator installed on the computer
incognito_modeStringWebStealth mode
headless_modeStringWebVirtual browser
abnormal_useragentStringWeb, Mini ProgramUA exception
debugger_detectedStringAndroid, iOS, WebDebugger detectedDebugger detected during SDK work
hook_tool_detectedStringAndroid, iOSModification tool detected
device_info_tamperedStringAndroid, iOS,Web, Mini ProgramDevice parameters have been tampered withIt was detected that device information has been tampered with
group_controlStringAndroid, iOSGroup controlUse cloud phones and group control devices
no_simStringAndroid, iOSNo sim card insertedThe device does not have a mobile phone card inserted
abnormal_device_attrStringAndroid, iOS, Web, Mini ProgramAbnormal device parametersHash verification exception, some fields hit special values
script_temperedStringWebScript has been tampered with
virtual_machineStringWebThe device is a virtual machineDevice detected as a virtual machine
local_debugStringWebLocal debuggingLocal debugging detected
adb_linkStringAndroidADB debuggingThe mobile device is connected to the PC and is in ADB debugging state.
repackagedStringAndroid, iOSSecondary packaging
proxy_detectedStringAndroid, iOS,Mini ProgramUse a proxy
rootStringAndroidroot
jail_breakStringiOSJail break
vpn_detectedStringAndroid, iOSVPN detected
replay_attacksStringAndroid, iOS, Web, Mini ProgramReplay attacksThe same device data is reported multiple times
cookie_temperedStringAndroid, iOS, WebCookie temperedClient device fingerprint cookie has been tampered with
crawlerStringWebReptile
malicious_crxStringWebMalicious extension
debug_toolStringWebDebugger tools
app_multiple_runningStringAndroidMultiple applications are running
sys_multiple_runningStringAndroidMultiple systems are running
gps_fakeStringAndroid, iOSVirtual positioning
risk_romStringAndroidSuspected risky ROMROM for non-native factory devices

Device risk tool explanation

ParameterTypeDescriptionNotes
installed_risk_tools_typeArrayList of installed risk tool typesRefer to the list of installed risk tool types explanation
running_risk_tools_typeArrayList of running risk tool typesRefer to the list of running risk tool types explanation

List of installed risk tool types explanation

ParameterAcceptable platformDescription
quick_macroAndroid, iOSQuickMacro
cydiaAndroidCydia
agent_appAndroid, iOSAgent app
more_openAndroidMore open
machine_change_toolsAndroid, iOSMachine change tools
code_receiving_platformAndroidCode receiving platform
magiskAndroidMagisk
virtual_appAndroidVirtualApp
virtual_positioningAndroid, iOSVirtual positioning
group_control_softwareAndroidGroup control software
xposedAndroidXposed
game_transmissionAndroidGame transmission
game_modifierAndroidGame modifier
cloud_simulatorAndroidCloud simulator
crowdsourcing_appAndroidcrowdsourcing app
skip_adsAndroidSkip advertisement
anti_crash_frameAndroidanti-crash framework
capture_toolAndroidCapture tool
fridaAndroidfrida

List of running risk tool types explanation

ParameterAcceptable platformDescription
quick_macroAndroidQuickMacro
cydiaAndroidCydia
magiskAndroidMagisk
test_frameAndroidTestFrame
virtual_appAndroidVirtualApp
xposedAndroidXposed
skip_adsAndroidSkip advertisement
fridaAndroidfrida
    {
        "device_id":"A1VHK6r9-T3E2-U77L-786n-6kn6ZJhQt5ee",
        "device_os":"Android",
        "device_detail":{
            "android_id":"591b4eb2a65e88f5",
            "api_version":"31",
            "app_version":"4.1.5.6",
            "available_memory":1509920768,
            "available_storage":31501324288,
            "baseband_version":"MOLY.LR12A.R3.MP.V98.1.P22",
            "battery_level":100,
            "brand":"Redmi",
            "bssid":"80:8d:b7:be:ef:16",
            "carrier":"China Unicom,-",
            "cell_ip":"11.77.85.128",
            "charge_state":"full",
            "country_iso":"cn",
            "cpu_hardware":"AArch64 Processor rev 2 (aarch64)",
            "cpu_type":"MT6771V/C",
            "current_time":1687772256849,
            "device_name":"lancelot",
            "device_svn":"07",
            "dns_address":"192.168.8.55",
            "fp_version":"4.1.5.6",
            "gps_location":{
                "address":"No. 450, Cangqian Town, Yuhang District, Hangzhou City, Zhejiang Province",
                "city":"Hangzhou City",
                "province":"Zhejiang Province",
                "township":"Cangqian Town"
            },
            "hardware":"mt6768",
            "host":"m1-xm-ota-bd274.bj.idc.xiaomi.com",
            "installed_packages":"[{"package":"com.miui.screenrecorder","name":"-"},{"package":"com.miui.fm","name":"-"},{"package":"com.mi.liveassistant","name":"-"},{"package":"com.xiaomi.vipaccount","name":"-"},{"package":"com.qiyi.video","name":"-"},{"package":"cn.tongdun.android.demo4156","name":"-"},{"package":"cn.tongdun.android.demo4159","name":"-"},{"package":"com.miui.thirdappassistant","name":"-"},{"package":"com.android.soundrecorder","name":"-"},{"package":"cn.wps.moffice_eng","name":"-"}]",
            "ip":"123.157.153.130",
            "ipv6":"fe80::5c5f:4e9c:b980:17c4",
            "language":"zh",
            "latitude":30.281102,
            "longitude":120.012233,
            "mcc":"460,",
            "mnc":"01,",
            "model":"M2004J19C",
            "network_type":"wifi",
            "package_name":"cn.tongdun.android.demo4156",
            "product":"lancelot",
            "proxy_info":"",
            "running_packages":"cn.tongdun.android.demo4156",
            "screen_brightness":256,
            "screen_resolution":"1080x2340",
            "sign_md5":"03ce925f76ceb40e1c2ed8bfe3fcdd0c480a7ba8689ff814c601edfbf79e339e",
            "sim_operator":"China Unicom,-",
            "ssid":"IT-YUNZM123",
            "startup_time":"2023-06-21 10:14:59",
            "system_version":"12",
            "time_zone":"UTC+08:00",
            "total_memory":3881115648,
            "total_storage":50979336192,
            "up_time":458557139,
            "vpn_ip":"",
            "wifi_ip":"10.57.201.50"
        },
        "ip_location":{
            "country":"China",
            "region":"Zhejiang",
            "city":"Hangzhou",
            "country_id":"CN",
            "continent":"Asia"
        },
        "device_risk_label":[
            "abnormal_network_connection"
        ],
        "device_risk_tools":{
            "installed_risk_tools_type":[
                "quick_macro"
            ],
            "running_risk_tools_type":[
                "quick_macro"
            ]
        }
    }