API 接口说明
接口方式
Base URL
- 中国节点: https://cn.apitd.net/device/v1
- 美国节点: https://us.apitd.net/device/v1
- 新加坡节点:https://sg.apitd.net/device/v1
- 德国节点: https://de.apitd.net/device/v1
- 印尼节点: https://id.apitd.net/device/v1
- 巴基斯坦: https://pk.apitd.net/device/v1
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 | 响应唯一码 | 存在 | 用于跟踪每次请求与响应的唯一标识 |
device_id | String | 设备唯一 ID | 存在 | 格式固定,长度36位的字符 |
device_os | String | 设备类型 | 存在 | Android、iOS、Harmony、Web、wxapp(微信小程序,仅中国节点提供)、myapp(支付宝小程序,仅中国节点提供)、ttapp(字节系小程序,仅中国节点提供)、swapp(百度小程序,仅中国节点提供)、jdapp(京东小程序,仅中国节点提供) |
device_detail | Object | 设备详情 | 仅 Pro 和 Enterprise 版本存在 | 参考设备详情说明 |
ip_location | Object | 设备对应的 IP 位置信息 | 仅 Pro 和 Enterprise 版本存在 | 参考 IP 位置信息说明 |
device_risk_score | Integer | 设备风险评分 | 仅 Pro 和 Enterprise 版本存在 | 范围为 0 - 100 |
device_risk_label | Array | 设备风险标签列表 | 仅 Enterprise 版本存在 | 参考设备风险标签列表说明 |
device_risk_tools | Object | 设备风险工具 | 仅 Enterprise 版本存在 | 参考设备风险工具说明 |
device_history_risk_labels | Array | 历史风险标签列表 | 仅 Enterprise 版本存在 | 参考历史风险标签参数说明 |
vpn_true_ip_location | Object | 设备对应的VPN 真实 IP 位置信息 | 仅 Enterprise 版本存在 | 参考VPN 真实 IP位置信息说明 |
设备详情
不同的设备类型对应的设备详情字段不尽相同,下面分别罗列了不同的设备类型对应的设备详情
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+0800" |
startup_time | String | 开机时间 | 例如 "2021-01-01 00:00:00" |
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 |
gps_location | String | GPS 定位信息 | 例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供) |
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" |
channel | String | 渠道 | 例如 "yingxiao_android" |
vpn_true_ip | String | VPN 真实 IP 地址 | 例如 "123.157.153.130" |
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+0800" |
startup_time | String | 开机时间 | 例如 "2021-01-01 00:00:00" |
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 | 总内存大小 | 字节数 |
available_memory | Long | 可用内存大小 | 字节数 |
total_storage | Long | 总存储大小 | 字节数 |
available_storage | Long | 可用存储大小 | 字节数 |
latitude | Double | 纬度 | 精确到小数点后 6 位,例如 30.282331 |
longitude | Double | 经度 | 精确到小数点后 6 位,例如 120.011395 |
gps_location | String | GPS 定位信息 | 例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供) |
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" |
channel | String | 渠道 | 例如 "yingxiao_ios" |
issue_region | String | 设备发行地区 | 例如 "CH/A" |
vpn_true_ip | String | VPN 真实 IP 地址 | 例如 "123.157.153.130" |
Harmony
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
fp_version | String | SDK 版本 | 例如 "1.0.2" |
screen_resolution | String | 屏幕分辨率 | 例如 "1344x2772" |
current_time | Long | 当前时间 | 例如 1711594081876 |
startup_time | String | 开机时间 | 例如 "2024-03-28 09:48:37" |
up_time | Long | 运行时间 | 例如 3503141 |
time_zone | String | 时区 | 例如 UTC+08:00 |
language | String | 语言 | 例如 "zh-Hans" |
charge_state | String | 充电状态 | 例如 "unknown"、"charging"、"unplugged、"unplugged"、"full" |
battery_level | Integer | 电量 | 例如 20 |
network_type | string | 网络类型 | 例如 "wifi" |
total_storage | Long | 存储大小 | 例如 243041042432 |
available_storage | Long | 可用存储大小 | 例如 231078236160 |
cell_ip | String | 本地 IP 地址 | 例如 "10.24.207.224" |
wifi_ip | String | 无线 IP 地址 | 例如 "192.168.101.38" |
vpn_ip | String | VPN IP 地址 | 例如 "198.18.0.1" |
proxy_info | string | 全局代理信息 | 例如 "10.57.241.80:8888" |
device_type | String | 设备类型 | 例如 "phone" |
brand | String | 设备品牌 | 例如 "HUAWEI" |
market_name | String | 市场名称 | 例如 "HUAWEI Mate 40 Pro" |
model | String | 型号 | 例如 "NON-AN00" |
hardware | String | 硬件 | 例如 "HN1NOAHM" |
serial_no | String | 设备序列号 | 例如 "05b37354f0dd7f2e" |
system_version | String | 系统版本 | 例如 "2.1.6.6(Beta2)" |
api_version | String | API版本 | 例如 "11" |
udid | String | udid | 例如 "default" |
package_name | string | 应用包名 | 例如 "com.example.harmonyosdemo" |
app_version | string | app 版本 | 例如 "1.0.1" |
sign_md5 | string | 签名 MD5 | 例如 "8CC29B99116E11A24A7762539327BB566D65773CB64C1521D68E67316DE1923F" |
country_iso | string | 国家代码 | 例如 "cn,-" |
sim_operator | string | SIM 卡运营商 | 例如 "中国移动,-" |
latitude | double | 纬度 | 取值范围为-90到90,保留6位小数点 |
longitude | double | 经度 | 取值范围为-180到180,保留6位小数点 |
ip | String | IP 地址 | 223.104.160.62 |
channel | String | 渠道 | 例如 "yingxiao_harmony" |
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+0800" |
screen_resolution | String | 屏幕分辨率 | 宽 x 高,例如:"720x1280" |
language | String | 语言 | 例如 "zh-CN" |
referer | String | 请求来源 | 例如:"http://10.57.30.164:8088/ " |
canvas | String | 帆布指纹 | 例如 "c8a8455d02d7cec9edbe980b6b9e0ff8" |
current_time | Long | 当前时间 | 例如 "1687680661250" |
channel | String | 渠道 | 例如 "yingxiao_web" |
vpn_true_ip | String | VPN 真实 IP 地址 | 例如 "123.157.153.130" |
latitude | Double | 纬度 | 精确到小数点后 6 位,例如 30.2823 |
longitude | Double | 经度 | 精确到小数点后 6 位,例如 120.0113 |
gps_location | String | GPS 定位信息 | 例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供) |
微信/支付宝/字节/百度/京东小程序(仅中国节点提供)
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
brand | String | 品牌 | 例如 "iPhone" |
browser | String | 浏览器名称 | 例如 "MicroMessenger" |
browser_type | String | 浏览器类型 | 例如 "Normal" |
font_size_setting | String | 字体大小 | 例如 "23.799999237060547"(京东小程序无该字段) |
language | String | 语言 | 例如 "zh_CN" |
model | String | 型号 | 例如 "iPhone 11" |
network_type | String | 网络类型 | 例如 "wifi" |
os | String | 客户端系统 | 例如 "IOS" |
screen_brightness | String | 屏幕亮度 | 例如 "0.717011570930481" |
screen_width | String | 屏幕宽度 | 例如 "414" |
screen_height | String | 屏幕高度 | 例如 "896" |
sdk_version | String | 客户端基础库版本 | 例如 "2.30.2" |
fp_version | String | SDK 版本 | 例如 "3.8.5" |
smart_id | String | 设备智能 ID | 例如 "s_bad1549e79b28f8200bdaacb8bc902d0" |
system | String | 操作系统版本 | 例如 "iOS 14.0" |
user_agent | String | userAgent | 例如 "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" |
version | String | 应用版本号 | 例如 "8.0.33" |
platform | String | 客户端平台 | 例如 "ios" |
ip | String | IP 地址 | 例如 "112.82.210.140" |
current_time | Long | 当前时间 | 例如 "1687680661250" |
channel | String | 渠道 | 例如 "yingxiao_mini" |
latitude | Double | 经度 | 精确到小数点后 6 位,例如 30.2823 |
longitude | Double | 纬度 | 精确到小数点后 6 位,例如 120.0113 |
gps_location | String | GPS 定位信息 | 例如 " {"address": "浙江省杭州市余杭区仓前镇文一西路998号","city": "杭州市","province": "浙江省","township": "仓前镇" }"(仅中国节点提供) |
IP位置信息
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
continent | String | 大洲 | 例如 "North America" |
country | String | 国家 | 例如 "United States" |
country_id | String | 国家代码 | 例如 "US" |
region | String | 省/州/地区 | 例如 "Virginia" |
city | String | 城市 | 例如 "Ashburn" |
设备风险标签
字段 | 类型 | 适用平台 | 描述 | 备注 |
---|---|---|---|---|
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 | 使用 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 | 应用多开 | |
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 | 屏幕共享 |
设备风险工具
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
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 | 巨魔商店 |
运行的风险工具类型
字段 | 适用平台 | 描述 | 备注 |
---|---|---|---|
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 | 巨魔商店 |
历史风险标签
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
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 | 使用 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 | 应用多开 | |
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 | 屏幕共享 |
VPN 真实 IP位置信息
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
continent | String | 大洲 | 例如 "North America" |
country | String | 国家 | 例如 "United States" |
country_id | String | 国家代码 | 例如 "US" |
region | String | 省/州/地区 | 例如 "Virginia" |
city | String | 城市 | 例如 "Ashburn" |
状态码
状态码 | 建议处理方式 | 是否计费 |
---|---|---|
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 | 调错环境,地址填写错误 | 否 |
响应示例
Basic
{
"code": 200,
"message": "",
"sequence_id": "xxxxxxxxxxxxxxxx",
"device_id": "xxxxxxx",
"device_os": "Android"
}
Pro
{
"code": 200,
"message": "",
"sequence_id": "xxxxxxxxxxxxxxxx",
"device_id": "xxxxxxx",
"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":"中国联通,-",
"cell_ip":"11.77.85.128",
"charge_state":"full",
"country_iso":"cn,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":"浙江省杭州市余杭区仓前镇450路",
"city":"杭州市",
"province":"浙江省",
"township":"仓前镇"
},
"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":"中国联通,-",
"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_score": 50
}
Enterprise
{
"code": 200,
"message": "",
"sequence_id": "xxxxxxxxxxxxxxxx",
"device_id": "xxxxxxx",
"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":"中国联通,-",
"cell_ip":"11.77.85.128",
"charge_state":"full",
"country_iso":"cn,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":"浙江省杭州市余杭区仓前镇450路",
"city":"杭州市",
"province":"浙江省",
"township":"仓前镇"
},
"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",
"channel": "apitest",
"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":"中国联通,-",
"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":"",
"vpn_true_ip":"123.157.153.122",
"wifi_ip":"10.57.201.50"
},
"ip_location": {
"country": "China",
"region": "Zhejiang",
"city": "Hangzhou",
"country_id": "CN",
"continent": "Asia"
},
"vpn_true_ip_location": {
"continent": "亚洲",
"country": "中国",
"city": "杭州市",
"region": "浙江省",
"country_id": "CN"
},
"device_risk_score":53,
"device_risk_label": [
"abnormal_network_connection"
],
"device_history_risk_label":[
{
"last_time":"1716361861027",
"label":"device_info_tampered"
},
{
"last_time":"1716363312554",
"label":"debugger_detected"
},
{
"last_time":"1722397927097",
"label":"abnormal_time"
}],
"device_risk_tools":{
"installed_risk_tools_type": [
"quick_macro"
],
"running_risk_tools_type": [
"quick_macro"
]
},
"device_risk_tags":[
]
}