TrustDecision
API Reference
中文
Start typing to search…

Device Call Log

Interface method

Base URL

API

URLRequest methodContent-TypeOutput formatCharacter set
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

Authentication

FieldTypeMeaningRequired fieldsRemarks
partner_codeStringPartner identifyYesProvided by TD
partner_keyStringPartner secret keyYesProvided by TD

Request

FieldTypeMeaningRequired fieldsRemarks
black_boxStringVouchers for access to device informationYesObtain from SDK

Example Request

{
  "black_box": "aGPH1658920283672ropYaFxT7"
}

Response

FieldTypeMeaningOutput situationRemarks
codeIntegerinterface response status codesAllRefer to the status code description
messageStringstatus InfoAllSpecific reasons for an exception
sequence_idStringunique Identifier IDAllA unique identifier for each request-response
anonymous_idStringanonymous IDAllCharacters with a fixed format and a length of 48 digits
device_osStringdevice typeAllAndroid、iOS、Web
channelStringchannelAllchannel
device_detailObjectdevice detailsAllPlease refer to the description of the device details
device_risk_scoreIntegerdevice risk scoreAllRange 0 - 10000,supports customization. For documentation, refer to risk score
device_risk_labelArraydevice risk label listAllPlease refer to the description of the device risk label
device_risk_toolsObjectdevice risk toolsAllPlease refer to the description of the device risk tools
device_history_risk_labelArraydevice history risk label listAllPlease refer to the description of the device history risk labels

Device Details

There are differences in the device fields corresponding to different device types and the following lists the field descriptions for the different device types

Android

FieldTypeMeaningRemarks
app_versionStringapp versionsE.g. "4.1.6"
system_versionStringandroid system versionsE.g. "6.0.1"
api_versionStringandroid API versionsE.g. "23"
fp_versionStringSDK versionsE.g. "4.1.6"
modelStringdevice modelE.g. "2014811"
brandStringdevice BrandE.g. "Xiaomi"
device_nameStringdevice nameE.g. "HM2014811"
network_typeStringnetwork typeE.g. "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown"
ipStringIP addressE.g. "123.157.153.130"
time_zoneStringtime zoneE.g. "UTC+08:00"
startup_timeLongboot timeE.g. 1741660150575
up_timeLonguptimeE.g. "568273951"
charge_stateStringcharging statusE.g. "charging"、"full"、"not_charging"、"discharging"、"unknown"
battery_levelIntegerelectrical quantitiesRange 0 - 100
screen_resolutionStringscreen resolutionWidth x Height，Example："720x1280"
screen_brightnessIntegerscreen brightnessRange -1 - 256
total_memoryLongtotal memory sizeBytes
available_memoryLongavailable memory sizeBytes
total_storageLongtotal storage sizeBytes
available_storageLongavailable storage sizeBytes
latitudeDoublelatitudeAccuracy to 6 decimal places， Example 30.282331
longitudeDoublelongitudeAccuracy to 6 decimal places， Example 120.011395
carrierStringcarrierE.g. "Viettel"
bssidStringbssidE.g. "00:1a:8c:a0:69:0a"
wifi_ipStringwifi ipE.g. "10.57.3.135"
device_svnStringdevice svnE.g. "07"
hardwareStringhardwareE.g. "qcom"
dns_addressStringdns addressE.g. "211.137.32.178"
productStringproductE.g. "A37T"
hostStringhostE.g. "qh-miui-ota-offline07"
sim_operatorStringsim operatorE.g. "Viettel,VinaPhone"
ssidStringssidE.g. "xiaoming 的 wifi"
vpn_ipStringvpn ipE.g. "10.251.37.229"
cell_ipStringcell ipE.g. "10.3.4.9"
current_timeLongcurrent timeE.g. "1687764437374"
package_nameStringpackage nameE.g. "cn.tongdun. android&3.0.0"
languageStringlanguageE.g. "zh"
android_idStringandroid idE.g. "952b0b1edda80b44"
cpu_hardwareStringcpu hardwareE.g. "ARMv7 Processor rev 0 (v7l)"
cpu_typeStringcpu typeE.g. "Qualcomm Technologies"
baseband_versionStringbaseband versionE.g. "MPSS.DPM.1.0.c7. 18-00023"
mncStringmobile network codeE.g. "01"
mccStringmobile country codeE.g. "460"
installed_packagesStringinstalled packagesE.g. "[{\"package\":\"com.miui.screenrecorder\",\"name\":\"-\"},{\"package\":\"com.miui.fm\",\"name\":\"-\"}]"
running_packagesStringrunning packagesE.g. "com.xiaomi.shop"
ipv6Stringipv6E.g. "fe80::bfd7:21d8:318a:693b"
sign_md5Stringsign md5E.g. "6fb472cac420436b773a6325d4cdd7bd"
proxy_infoStringproxy infoE.g. "42.235.30.24:8080"
country_isoStringiso country codeE.g. "cn,cn"
aidStringgoogle advertising idE.g. "db13e159-1058-46fc-a4dc-4d2f8197f3af"
vpn_true_ipStringvpn true ip addressE.g. "123.157.153.130"
audio_modeIntegeraudio modeE.g. 0 - Normal mode,1 - Ringtone mode,2 - Call mode,3 - Communication mode,4 - Call screening is in progress

iOS

FieldTypeMeaningRemarks
app_versionStringapp versionsE.g. "1.0.3"
system_versionStringios system versionsE.g. "10.2.1"
fp_versionStringSDK versionsE.g. "4.1.2"
modelStringdevice modelE.g. "iPhone 6s"
device_nameStringdevice nameE.g. "iPhone"
network_typeStringnetwork typeE.g. "2g"、"3g"、"4g"、"5g"、"wifi"、"mobile"、"bluetooth_tethering"、"unknown"
ipStringIP addressE.g. "123.157.153.130"
time_zoneStringtime zoneE.g. "UTC+08:00"
startup_timeLongboot timeE.g.1741660150575
up_timeLonguptimeE.g. 568273951
charge_stateStringcharging statusE.g. "charging"、"unplugged"、"unknown"
battery_levelIntegerelectrical quantitiesRange 0 - 100
screen_resolutionStringscreen resolutionWidth x Height，Example："720x1280"
screen_brightnessIntegerscreen brightnessRange 0 - 100
total_memoryLongtotal memory sizeBytes
total_storageLongtotal storage sizeBytes
available_storageLongavailable storage sizeBytes
latitudeDoublelatitudeAccuracy to 6 decimal places， Example 30.282331
longitudeDoublelongitudeAccuracy to 6 decimal places， Example 120.011395
current_timeStringcurrent timeE.g. "1687764437374"
cell_ipStringcell ipE.g. "10.5.2.39"
wifi_ipStringwifi ipE.g. "192.168.10.111"
languageStringlanguageE.g. "en"
carrierStringcarrierE.g. "Viettel,VinaPhone"
mncStringmobile network codeE.g. "0"
mccStringmobile country codeE.g. "460"
country_isoStringiso country codeE.g. "cn"
bundle_idStringbundle idE.g. "cn.fraudmetrix. FMDeviceManager"
proxy_infoStringproxy infoE.g. "10.2.3.4:8080"
ssidStringssidE.g. "TP-LINK_03FE"
bssidStringbssidE.g. "80:2f:3e:dd:03:fe"
dns_addressStringdns addressE.g. "192.168.10.1"
vpn_ipStringvpn ipE.g. "10.32.3.98"
ipv6Stringipv6E.g. "fe08:393ed3"
idfaStringidentifier for dvertisersE.g. "5D26C201-7FEF-44A6-B57A-1D10E2E2EC63"
issue_regionStringissue regionE.g. "CH/A"
vpn_true_ipStringvpn true ip addressE.g. "123.157.153.13
microphone_use_stateIntegermicrophone use stateE.g.-1: No available microphone,0: Not in a call state,1: In a call state

Web

FieldTypeMeaningRemarks
browser_nameStringbrowser nameE.g. "Chrome"
browser_versionStringbrowser versionE.g. "56.0.2924.87"
fp_versionStringSDK versionsE.g."3.8.5"
user_agentStringbrowser userAgentE.g. "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"
urlStringuniform resource locatorE.g. "file:///Users/td/Documents/td/fp/demo_web.html"
device_typeStringdevice typeE.g. "Mac"
osStringdevice operating systemE.g. "Mac OS"
ipStringip addressesE.g. "123.157.153.130"
time_zoneStringtime zoneE.g. "UTC+08:00"
screen_resolutionStringscreen resolutionWidth x Height，Example："720x1280"
languageStringlanguageE.g. "zh-CN"
refererStringrefererE.g."http://10.57.30.164:8088/"
canvasStringcanvasE.g. "c8a8455d02d7cec9e dbe980b6b9e0ff8"
current_timeLongcurrent timeE.g. "1481694227762"
vpn_true_ipStringvpn true ip addressE.g. "123.157.153.13
latitudeDoublelatitudeAccuracy to 6 decimal places， Example 30.282331
longitudeDoublelongitudeAccuracy to 6 decimal places， Example 120.011395

Device Risk Label

FieldTypeApplicable platformDescriptionRemarks
abnormal_timeStringAndroid, iOS, Web,Mini programcurrent device time abnormalExcessive deviation of device times from actual times
emulatorStringAndroid, iOS, Web,Mini program,Harmonydevice is a simulatorThe device is an emulator installed on the computer
incognito_modeStringWebincognito mode
headless_modeStringWeb,Minivirtual browser
abnormal_useragentStringWeb,Mini programuseragent abnormal
debugger_detectedStringAndroid, iOS, Web,Mini(wechat)debugger is detectedDebugger is detected
hook_tool_detectedStringAndroid, iOS,Webhook tool detected
device_info_tamperedStringAndroid, iOS,Web,Mini programtampering with device parametersDevice information tampering detected
group_controlStringAndroid, iOSgroup controlUsing cloud handsets, group control devices
no_simStringAndroid, iOS、Harmonywithout sim card insertedDevice without a sim card inserted
abnormal_device_attrStringiOS, Web,Mini programdevice parameter abnormalHash check exceptions, some fields hit special values
script_temperedStringWebscript tampering
virtual_machineStringWebdevice as a virtual machineThe current device is detected as a virtual machine
local_debugStringWeblocal debuggingLocal debugging detected
adb_linkStringAndroidandroid debug bridgeMobile device connected to PC, in ADB debugging state
repackagedStringAndroid, iOSsecondary packaging
proxy_detectedStringAndroid, Harmony,iOS,Mini program(wechat)using a proxy
rootStringAndroidroot
jail_breakStringiOSjailbreak devices
vpn_detectedStringAndroid, iOS,Web,Harmonyusing vpn
replay_attacksStringAndroid,Harmony ,iOS, Web,Mini programreplay attackThe current device information has been repeatedly requested several times
cookie_temperedStringAndroid, Harmony、iOS, Web,Mini programcookie tamperingCookie tampering on client device fingerprint
crawlerStringWebweb crawler
malicious_crxStringWebmalicious extension plugins
debug_toolStringWebdebugger tools
app_multiple_runningStringAndroid,iOSapp multi opening
sys_multiple_runningStringAndroidsystem multi opening
gps_fakeStringAndroid, iOS,Mini program(wechat)virtual positioning
risk_romStringAndroidsuspected risk romROMs for non-native factory devices
camera_fakeStringAndroid, iOScamera fake
suspected_resetStringAndroid, iOSsuspected reset
short_uptimeStringAndroid, iOS,Harmonyshort uptime
screen_sharingStringAndroid, iOS,Harmonyscreen sharing
cloud_phoneStringAndroid, iOS,Mini program(wechat)cloud phone
device_callStringAndroid, iOS,Harmonydevice call
anti_association_browserStringWebanti association browser
offline_attackStringWeboffline attack

Device Risk Tools

FieldtypeDescriptionRemarks
installed_risk_tools_typeArrayinstallation risk tool Type descriptionPlease refer to installation risk tool Type description
running_risk_tools_typeArraydescription of the type of risk tool runningPlease refer to the description of the type of risk tool running

Installation Risk Tools

FieldApplicable platformDescriptionRemarks
quick_macroAndroid, iOSauto click tool
cydiaAndroidCydia
agent_appAndroid, iOSagent app
more_openAndroiddouble open tool
machine_change_toolsAndroid, iOShook tools
code_receiving_platformAndroidcode receiving platform
magiskAndroidMagisk
group_control_softwareAndroidgroup control software
virtual_appAndroidVirtualApp
virtual_positioningAndroid, iOSGPS location fake
xposedAndroidXposed
game_transmissionAndroidgame transmission
game_modifierAndroidgame modifier
cloud_simulatorAndroidcloud simulator
crowdsourcing_appAndroidcrowdsourcing app
skip_adsAndroidskip ads
anti_crash_frameAndroidanti crash frame
capture_toolAndroidcapture tool
fridaAndroidfrida
troll_storeiOSTrollStore
cloud_phoneiOScloud phone
root_managerAndroidroot manager
remote_controlAndroidremote control
screen_casting_softwareAndroidscreen casting software

Running Risk Tools

FieldApplicable platformDescriptionRemarks
quick_macroAndroidauto click tool
cydiaAndroidCydia
magiskAndroidMagisk
test_frameAndroidTestFrame
virtual_appAndroidVirtualApp
xposedAndroidXposed
capture_toolAndroidcapture tool
fridaAndroidfrida
troll_storeiOSTrollStore
remote_controlAndroidremote control
screen_casting_softwareAndroidscreen casting software

Device History Risk Labels

FieldtypeDescriptionRemarks
labelStringrisk labelReference device history risk label list “f”
last_timeStringlast time13 digit timestamp

Device History Risk Label List

FieldTypeApplicable platformDescriptionRemarks
abnormal_timeStringAndroid, iOS, Web,Mini programcurrent device time abnormalExcessive deviation of device times from actual times
emulatorStringAndroid, iOS, Web,Mini program,Harmonydevice is a simulatorThe device is an emulator installed on the computer
incognito_modeStringWebincognito mode
headless_modeStringWeb,Mini programvirtual browser
abnormal_useragentStringWeb,Mini programuseragent abnormal
debugger_detectedStringAndroid, iOS, Web,Mini program(wechat)debugger is detectedDebugger is detected
hook_tool_detectedStringAndroid, iOShook tool detected
device_info_tamperedStringAndroid, Webtampering with device parametersDevice information tampering detected
group_controlStringAndroid, iOSgroup controlUsing cloud handsets, group control devices
no_simStringAndroid, iOS,Harmonywithout sim card insertedDevice without a sim card inserted
abnormal_device_attrStringiOS, Web,Mini programdevice parameter abnormalHash check exceptions, some fields hit special values
script_temperedStringWebscript tampering
virtual_machineStringWebdevice as a virtual machineThe current device is detected as a virtual machine
local_debugStringWeblocal debuggingLocal debugging detected
adb_linkStringAndroidandroid debug bridgeMobile device connected to PC, in ADB debugging state
repackagedStringAndroid, iOSsecondary packaging
proxy_detectedStringAndroid, Harmony,iOS,Mini program(wechat)using a proxy
rootStringAndroidroot
jail_breakStringiOSjailbreak devices
vpn_detectedStringAndroid, iOS,Web,Harmonyusing vpn
replay_attacksStringAndroid,Harmony ,iOS, Web,Mini programreplay attackThe current device information has been repeatedly requested several times
cookie_temperedStringAndroid, Harmony、iOS, Web,Mini programcookie tamperingCookie tampering on client device fingerprint
crawlerStringWebweb crawler
malicious_crxStringWebmalicious extension plugins
debug_toolStringWebdebugger tools
app_multiple_runningStringAndroid,iOSapp multi opening
sys_multiple_runningStringAndroidsystem multi opening
gps_fakeStringAndroid, iOS,Mini program(wechat)virtual positioning
risk_romStringAndroidsuspected risk romROMs for non-native factory devices
camera_fakeStringAndroid, iOScamera fake
suspected_resetStringAndroid, iOSsuspected reset
short_uptimeStringAndroid, iOS,Harmonyshort uptime
screen_sharingStringAndroid, iOSscreen sharing
cloud_phoneStringAndroid, iOS,Mini program(wechat)cloud phone
device_callStringAndroid, iOS,Harmonydevice call
anti_association_browserStringWebanti association browser
offline_attackStringWeboffline attack

Status Code

Status Code

Suggestion

200


306

No available traffic, please contact operations

406

Wrong region，Version is not support

500

Application exception, reserved errors, can be ignored

512

Service not purchased, please contact operations

513

Traffic disabled, please contact operations

514

Service expired, please contact operations

515

Lack of traffic, please contact operations

9150

Wrong region，device os not support

9151

Authentication failed, please check the authentication parameters

9152

Service exception, reserved errors, can be ignored

9153

Internal exception, reserved errors, maybe attacked

9154

SDK exception, please check the integration

9155

Replay, please mark

9156

Missing file, reserved errors, please check the integration

9157

Time out, please retry

9158

BlackBox forgery, please mark

9159

Missing blackBox, please check your code

9160

Wrong environment, confusion between production and testing environments

9161

BlackBox expired, prohibit caching blackBox

9162

Content type is not support

9163

Wrong region,Wrong address

Example of response

{
    "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"
}