数美-设备指纹#


版权所有 翻版必究


设备指纹#

调用时机#

在需要进行风险识别时调用本接口,例如:

  1. 新用户注册后,进行风险画像查询,用于新人红包、注册礼物等的差异化投放;
  2. 存量用户登录后,进行风险画像查询,用于日常活动运营的差异化投放;
  3. 活动奖励下发前,进行风险画像查询,例如随机红包、抽奖等概率性活动;
  4. 每日的例行查询,进行画像库或风控引擎的数据更新。

具体接口#

请求URL:#

集群URL支持产品列表
北京集群http://api-tianxiang-bj.fengkongcloud.com/tianxiang/v4天象风险识别
新加坡集群http://api-tianxiang-xjp.fengkongcloud.com/tianxiang/v4天象风险识别
法兰克福集群http://api-tianxiang-eur.fengkongcloud.com/tianxiang/v4天象风险识别
弗吉尼亚集群http://api-tianxiang-fjny.fengkongcloud.com/tianxiang/v4天象风险识别

请求方法:#

POST

字符编码:#

UTF-8

建议超时时间:#

1s

请求参数:#

放在HTTP Body中,采用Json格式,具体参数如下:

请求参数名类型参数说明是否必传规范
accessKeystring接口认证密钥
用于权限认证,开通账号服务时由数美提供或使用开通邮箱登录数美后台右上角相关文档处查看
必传参数数美分配
datajson_object请求的数据内容必传参数请求的数据内容,最长10MB,详见data参数
其中,data的内容如下:
请求参数名类型参数说明是否必传规范
deviceIdstring待查询的设备指纹ID,由数美SDK生成不能为空该ID为用户设备的唯一标识,且与其他数美接口的smid保持一致

返回结果#

放在HTTP Body中,采用Json格式,具体参数如下:

参数名称参数类型参数说明是否必返规范
codeint返回码1100:成功
1901:QPS超限
1902:参数不合法
1903:服务失败
1911:图片下载失败
9101:无权限操作
3000:运营商错误
除message和requestId之外的字段,只有当code为1100时才会存在
messagestring返回码描述和code对应:成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作
requestIdstring请求标识请求唯一标识,用于排查问题和后续效果优化,强烈建议保存
profileExistint设备画像存在1:画像库中存在该设备信息0:画像库中不存在该设备信息
deviceLabelsjson_object设备标签信息见下面详情内容,仅在deviceId传入且服务开通时返回
devicePrimaryInfoJson_object设备属性信息需要开通rawdata 上报,(建议使用加密返回接口v2/device/rawdata)
deviceRiskLabelsjson_array设备风险标签见下面详情内容,仅在deviceId传入且服务开通时返回

其中

1)deviceLabels结果的详情内容

返回结果参数名参数类型参数说明规范
idstring设备标识
last_active_tsint设备数据最后一次上传时间可作为标签最后更新时间
fake_devicejson_object虚假信息相关的标签信息
device_suspicious_labelsjson_object设备可疑相关的标签信息
device_active_infojson_object设备活跃相关的标签信息
monkey_deviceJson_object机器操控设备相关的标签信息

fake_device的详情内容如下:

返回结果参数名参数类型参数说明规范
b_pc_emulatorintPC模拟器PC上运行的安卓模拟器,如雷电,取值:0:非PC模拟器1:是PC模拟器
b_pc_emulator_last_tsintPC模拟器时间
b_cloud_deviceint云手机设备云端手机设备,如红手指,取值:0:非云手机设备1:是云手机设备
b_cloud_device_last_tsint云手机设备时间
b_alteredint篡改设备篡改设备信息,使设备ID被篡改,取值:0:非篡改设备1:是篡改设备
b_altered_last_tsint篡改设备时间
b_multi_boxingint多开设备多开工具进行的多开,如分身大师,且当前APP处于多开环境中,取值:0:当前未处在多开环境中1:当前处在多开环境中
b_multi_boxing_last_tsint多开设备时间
b_fakerint伪造设备设备数据上报时全部或部分关键数据缺失或被伪造,进而伪造设备ID打业务接口的恶意行为,取值:0:非伪造设备1:是伪造设备
b_faker_last_tsint伪造设备时间
b_farmerint农场设备自动化操作的多台设备,组成设备农场,批量作恶,取值:0:非农场设备1:是农场设备
b_farmer_last_tsint农场设备时间
b_offerwallint积分墙设备安装积分墙等网赚类工具的设备,取值:0:非积分墙设备1:是积分墙设备
b_offerwall_last_tsint积分墙设备时间
otherjson_object其他虚假设备
b_phone_emulatorint手机模拟器手机上运行的安卓模拟器,如vmos,取值:0:非手机模拟器1:是手机模拟器
b_phone_emulator_last_tsint手机模拟器时间
b_alter_routeint篡改地理位置设备篡改gps位置,取值:0:设备没有篡改gps信息1:设备篡改gps信息
b_alter_route_last_tsint篡改地理位置标签最后时间13位时间戳
b_alter_route_periodsarray篡改地理位置行程时间段取值为每次行程中检测到第一次到最后一次篡改 地理位置的时间段。示例:b_alter_route_periods:[1616688431748- 1616688431749, 1616688431766- 1616688431799]
b_multi_boxing_by_os系统多开系统自带的多开,且当前APP处于多开环境中,取值:0:当前未处在多开环境中1:当前处在多开环境中
b_multi_boxing_by_os_last_tsint最后一次系统多开时间13位时间戳
b_multi_boxing_by_app工具多开多开工具进行的多开,如分身大师,且当前APP处于多开环境中,取值:0:当前未处在多开环境中1:当前处在多开环境中
b_multi_boxing_by_app_last_tsint最后一次工具多开时间13位时间戳
b_pc_emulator_pc_idstring模拟器所在pc设备id相同的pc上开启的多个同型号的模拟器,b_pc_emulator_pc_id值相同 , 仅使用sdk3.2.2及以上版本sdk才会存在以上标签。

other的详情内容如下:

返回结果参数名参数类型参数说明规范
b_mismatchint设备参数不匹配设备参数与正常参数不匹配,例如8核手机检测为3核等,取值:0:参数正常1:参数不正常
b_mismatch_last_tsint设备参数不匹配时间

device_suspicious_labels的详情内容如下:

返回结果参数名参数类型参数说明规范
b_rootintroot设备设备被root,取值:0:设备未被root1:设备被root
b_root_last_tsintroot时间
b_simintsim卡状态设备的sim卡状态异常,如无sim卡或sim卡不能正常工作,取值:0:sim卡状态正常1:sim卡状态异常
b_sim_last_tsintsim卡时间
b_debuggableint调试模式开启调试模式,开发者或黑产都有可能,取值:0:未处于调试模式1:处于调试模式
b_debuggable_last_tsint调试模式时间
b_vpnintVPN使用VPN代理IP,可能用于翻墙或黑产作恶,取值:0:未使用VPN1:使用VPN
b_vpn_last_tsintVPN时间
b_monkey_appsint自动化工具安装如按键精灵、触动精灵等自动化框架的设备,取值:0:暂未发现安装自动化工具1:安装自动化工具
b_monkey_apps_last_tsint自动化工具时间
b_accint辅助服务设备已开启辅助服务,具备自动化操作能力,也可能被某些软件用于自动化安装,取值:0:未开启辅助服务1:开启辅助服务
b_acc_last_tsint辅助服务时间
b_multi_boxing_appsint多开工具设备安装了多开工具,但不一定是针对当前APP进行多开,取值:0:暂未发现安装多开工具1:安装多开工具
b_multi_boxing_apps_last_tsint多开时间
b_hookint是否hook设备进程是否被注入其他代码或库。取值:0:进程未被注入其他代码或库1:进程被注入其他代码或库
b_hook_last_tsinthook时间
b_vpn_appsintVPN工具安装如芝麻代理等VPN工具的设备,取值:0:暂未发现1:安装VPN工具
b_vpn_apps_last_tsintVPN工具时间
b_manufactureint工程模式设备进入工程模式:0:未处于工程模式1:处于工程模式
b_manufacture_last_tsint工程模式时间
b_icloudint未登录iCloud账号设备未登录iCloud账号,取值:0:设备已登录iCloud账号1:设备未登录iCloud账号
b_icloud_last_tsint未登录iCloud账号时间
b_wx_codeint微信接码平台安装微信接码平台的设备,取值:0:暂未发现安装微信接码平台1:安装微信接码平台
b_wx_code_last_tsint微信接码平台时间
b_sms_codeint短信接码平台安装短信接码平台的设备,取值:0:暂未发现安装短信接码平台1:安装短信接码平台
b_sms_code_last_tsint短信接码平台时间
b_low_osverint低操作系统版本ios设备操作系统版本小于9,取值:0:ios设备操作系统版本不小于91:ios设备操作系统版本小于9
b_low_osver_last_tsint低操作系统版本时间
b_remote_control_appsint远程操控工具设备使用远程操控工具,取值:0:设备没有使用远程操控工具1:设备使用远程操控工具
b_remote_control_apps_last_tsint远程操控工具时间
b_repackageint重打包app名与签名不匹配,取值:0: app名与签名匹配1: app名与签名不匹配
b_repackage_last_tsint重打包时间
b_alter_locint篡改地理位置设备篡改地理位置,取值:0:设备没有篡改地理位置1:设备篡改地理位置
b_alter_loc_last_tsint篡改地理位置时间
b_resetint疑似重置设备疑似重置,取值:0: 设备没有疑似重置1: 设备疑似重置
b_reset_last_tsint疑似重置时间
b_consoleint开启调试模式设备开启调试模式,取值:0:设备没有开启调试模式1:设备开启调试
b_console_last_tsint开启调试模式时间
b_alter_appsint安装篡改工具设备安装篡改工具,如:应用变量,取值:0:设备没有安装篡改工具1:设备安装篡改工具
b_alter_apps_last_tsint安装篡改工具时间
b_game_cheat_appsint安装游戏外挂工具设备安装游戏外挂工具,如:应用变量,取值:0:设备没有安装游戏外挂工具1:设备安装游戏外挂工具
b_game_cheat_apps_last_tsint安装游戏外挂工具时间
b_adb_enableint开发者模式开启adb标签为1说明该设备开启了开发者模式,且开启了adb调试。仅sdk3.1.0版本以上能够识别
b_adb_enable_last_tsint开发者模式开启adb时间

device_active_info的详情内容如下:

返回结果参数名参数类型参数说明规范
i_smid_boot_timestampint系统启动时间

monkey_device的详情内容如下:

返回结果参数名参数类型参数说明规范
commonint通用
monkey_gameint游戏操控
monkey_readint咨询阅读

common的详情内容如下:

返回结果参数名参数类型参数说明规范
b_monkey_appsint机器操控工具安装如按键精灵、触动精灵等自动化框架的设备,取值:0:暂未发现安装机器操控工具1:安装机器操控工具
b_monkey_apps_last_tsint机器操控工具时间
b_webdriverint浏览器自动操作插件浏览器自动操作插件,取值:0:浏览器没有自动操作插件1:浏览器自动操作插件
b_webdriver_last_tsint浏览器自动操作插件时间

monkey_game的详情内容如下:

返回结果参数名参数类型参数说明规范
b_monkey_game_appsint游戏操控工具安装如游戏蜂窝等游戏操控工具的设备,取值:0:暂未发现1:安装游戏操控工具
b_monkey_game_apps_last_tsint游戏操控工具时间

monkey_read的详情内容如下:

返回结果参数名参数类型参数说明规范
b_monkey_read_appsint资讯阅读工具安装如聚合阅读等资讯阅读工具的设备,取值:0:暂未发现1:安装资讯阅读工具
b_monkey_read_apps_last_tsint资讯阅读工具时间

3)设备属性标签字段说明

标签名称返回字段
辅助服务信息acc
安卓IDadid
app包名appname
APP版本appver
可用空间availableSpace
基带版本band
电池电量battery
电池充电状态batteryState
手机启动时间boot
手机屏幕亮度brightness
wifi热点的MAC地址bssid
CPU核数量cpuCount
CPU频率cpuFreq
CPU型号cpuModel
app私有文件路径files
剩余空间freeSpace
输入法列表input
总内存memory
模拟定位开关mockLoc
手机网络连接方式network
运营商编码operator
手机系统(android、ios)os
Android操作系统版本osver
屏幕分辨率screen
数美SDK版本号sdkver
签名信息signdn
wifi名称ssid
采集数据时的时间戳devicet
总空间totalSpace
wifi的IP地址wifiip
Android项目设置的targetSDK版本号targetSdk
屏幕是否开启screenOn
国内设备标识oaid
adb开启adbEnabled
sim卡状态simstate
usb状态usbstate
型号model
主板型号board
品牌brand
厂商manufacturer
rom包信息fingerprint
cpu架构abi
启动标识bootId
设备启动时间bootTime
所属国家countryIso
app安装时间installTime
系统版本号osverStr
屏幕的分辨率scaledDensity
iCloud令牌ubiquityIdentityToken
系统升级时间updateTimes
用户设备类型userInterfaceIdiom

4)deviceRiskLabels的详情内容

返回结果参数名参数类型参数说明规范
label1string一级标签展示设备风险标签的一级标签。
label2string二级标签展示设备风险标签的二级标签。
label3string三级标签展示设备风险标签的三级标签。
descriptionstring风险描述展示设备风险标签的中文描述。
timestampint64最近一次命中策略的时间最近一次命中策略的时间
detailjson_object证据描述证据细节

5)设备风险三级表签说明

一级标签一级标识二级标签二级标识三级标签三级标识
id设备唯一标识id设备唯一标识id设备唯一标识
risk_device风险设备fake_device虚假设备b_pc_emulatorPC模拟器
risk_device风险设备fake_device虚假设备b_cloud_device云手机设备
risk_device风险设备fake_device虚假设备b_phone_emulator手机模拟器
risk_device风险设备fake_device虚假设备b_alter_route行程中篡改地理位置
risk_device风险设备fake_device虚假设备b_altered篡改设备
risk_device风险设备fake_device虚假设备b_multi_boxing_by_os系统多开
risk_device风险设备fake_device虚假设备b_multi_boxing_by_app工具多开
risk_device风险设备fake_device虚假设备b_multi_boxing多开设备
risk_device风险设备fake_device虚假设备b_faker伪造设备
risk_device风险设备fake_device虚假设备b_farmer农场设备
risk_device风险设备fake_device虚假设备b_offerwall积分墙设备
risk_device风险设备fake_device虚假设备b_mismatch参数不合法
risk_device风险设备monkey_device机器操控设备b_monkey_apps安装自动操作工具
risk_device风险设备monkey_device机器操控设备b_webdriver浏览器自动操作插件
risk_device风险设备monkey_device机器操控设备b_monkey_game_apps游戏操控 (monkey_game)
risk_device风险设备monkey_device机器操控设备b_monkey_read_apps资讯阅读 (monkey_read)
risk_device风险设备device_suspicious_labels设备可疑标签b_rootroot
risk_device风险设备device_suspicious_labels设备可疑标签b_simsim卡
risk_device风险设备device_suspicious_labels设备可疑标签b_alter_apps安装篡改工具
risk_device风险设备device_suspicious_labels设备可疑标签b_debuggable调试模式
risk_device风险设备device_suspicious_labels设备可疑标签b_vpnVPN
risk_device风险设备device_suspicious_labels设备可疑标签b_vpn_appsVPN工具
risk_device风险设备device_suspicious_labels设备可疑标签b_acc辅助服务
risk_device风险设备device_suspicious_labels设备可疑标签b_multi_boxing_apps多开工具
risk_device风险设备device_suspicious_labels设备可疑标签b_hookhook
risk_device风险设备device_suspicious_labels设备可疑标签b_manufacture工程模式
risk_device风险设备device_suspicious_labels设备可疑标签b_icloudiCloud账号
risk_device风险设备device_suspicious_labels设备可疑标签b_wx_code微信接码平台
risk_device风险设备device_suspicious_labels设备可疑标签b_sms_code短信接码平台
risk_device风险设备device_suspicious_labels设备可疑标签b_low_osver低操作系统版本
risk_device风险设备device_suspicious_labels设备可疑标签b_remote_control_apps远程操控工具
risk_device风险设备device_suspicious_labels设备可疑标签b_repackage重打包
risk_device风险设备device_suspicious_labels设备可疑标签b_console开启控制台
risk_device风险设备device_suspicious_labels设备可疑标签b_reset疑似重置
risk_device风险设备device_suspicious_labels设备可疑标签b_alter_loc篡改地理位置
risk_device风险设备device_suspicious_labels设备可疑标签b_game_cheat_apps安装游戏外挂工具
risk_device风险设备device_suspicious_labels设备可疑标签b_headless无头浏览器

示例:#

请求示例:#

{
"accessKey": "xxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"tokenId": "ceshizhanghao",
"deviceId": "ceshideviceId",
"phone": "ceshiphone"
}
}

同步返回示例:#

{
"code": 1100,
"message": "成功",
"profileExist": 1,
"requestId": "7a5445716f0581c2ab1d381a6af4d1b8",
"deviceLabels": {
"id": "2021071119130f6ed7400157056a2e38a139",
"fake_device": {
"b_pc_emulator": 1,
"b_pc_emulator_last_ts": 1587711321232,
"b_cloud_device": 1,
"b_cloud_device_last_ts": 1587711321232,
"b_altered": 1,
"b_altered_last_ts": 1587711321232,
"b_multi_boxing": 1,
"b_multi_boxing_last_ts": 1587711321232,
"b_multi_boxing_by_os": 1,
"b_multi_boxing_by_os_last_ts": 1587711321232,
"b_multi_boxing_by_app": 1,
"b_multi_boxing_by_app_last_ts": 1587711321232,
"b_faker": 1,
"b_faker_last_ts": 1587711321232,
"b_farmer": 1,
"b_farmer_last_ts": 1587711321232,
"b_offerwall": 1,
"b_offerwall_last_ts": 1587711321232,
"b_pc_emulator_pc_id": "202107111953184e8130f6ed7400157056a2e38a139",
"other": {
"b_mismatch": 1,
"b_mismatch_last_ts": 1587711321232
}
},
"device_suspicious_labels": {
"b_root": 1,
"b_root_last_ts": 1587711321232,
"b_sim": 1,
"b_sim_last_ts": 1587711321232,
"b_debuggable": 1,
"b_debuggable_last_ts": 1587711321232,
"b_vpn": 1,
"b_vpn_last_ts": 1587711321232,
"b_monkey_apps": 1,
"b_monkey_apps_last_ts": 1587711321232,
"b_acc": 1,
"b_acc_last_ts": 1587711321232,
"b_multi_boxing_apps": 1,
"b_multi_boxing_apps_last_ts": 1587711321232,
"b_hook": 1,
"b_hook_last_ts": 1587711321232,
"b_vpn_apps": 1,
"b_vpn_apps_last_ts": 1587711321232,
"b_manufacture": 1,
"b_manufacture_last_ts": 1587711321232,
"b_icloud": 1,
"b_icloud_last_ts": 1587711321232,
"b_wx_code": 1,
"b_wx_code_last_ts": 1587711321232,
"b_sms_code": 1,
"b_ sms_code _last_ts": 1587711321232,
"b_low_osver": 1,
"b_ low_osver_last_ts": 1587711321232,
"b_remote_control_apps": 1,
"b_remote_control_apps_last_ts": 1587711321232,
"b_repackage": 1,
"b_repackage_last_ts": 1587711321232,
"b_reset": 1,
"b_reset_last_ts": 1587711321232,
"b_console": 1,
"b_console_last_ts": 1587711321232,
"b_alter_apps": 1,
"b_alter_apps_last_ts": 1587711321232,
"b_game_cheat_apps": 1,
"b_game_cheat_apps_last_ts": 1587711321232,
"b_adb_enable": 1,
"b_adb_enable_last_ts": 1587711321232
},
"device_active_info": {
"i_smid_boot_timestamp": 1587711321232
},
"monkey_device": {
"common": {
"b_monkey_apps": 0,
"b_monkey_apps_last_ts": 1587711321232,
"b_webdriver": 0,
"b_webdriver_last_ts": 1587711321232
},
"monkey_game": {
"b_monkey_game_apps": 0,
"b_monkey_game_apps_last_ts": 1587711321232
},
"monkey_read": {
"b_monkey_read_apps": 0,
"b_monkey_read_apps_last_ts": 1587711321232
}
}
},
"devicePrimaryInfo": {
"abi": null,
"acc": null,
"adbEnabled": null,
"adid": null,
"appname": "com.opay.pay",
"appver": "2.8.0",
"availableSpace": null,
"band": null,
"battery": 1,
"batteryState": 2,
"board": null,
"boot": 1650398254303,
"bootId": "A724B567-DBE4-42F0-842B-E620D730C844",
"bootTime": 1650398373,
"brand": null,
"brightness": 0.114379048347473,
"bssid": null,
"countryIso": "ng",
"cpuCount": 2,
"cpuFreq": null,
"cpuModel": null,
"devicet": 1650425202076,
"files": null,
"fingerprint": null,
"freeSpace": 47245746176,
"input": null,
"installTime": 1650425202,
"manufacturer": null,
"memory": 1037041664,
"mockLoc": null,
"model": "iPhone7,2",
"network": "UNKNOWN",
"oaid": null,
"operator": "62150",
"os": "ios",
"osver": "12.5.4",
"osverStr": "Version 12.5.4 (Build 16H50)",
"scaledDensity": 2,
"screen": "667,375",
"screenOn": null,
"sdkver": "3.0.6",
"signdn": null,
"simstate": null,
"ssid": "null",
"targetSdk": null,
"totalSpace": 63989469184,
"ubiquityIdentityToken": "\u003cdda70f66 d6605cc5 b0521820 695e53ec 9fe063d9\u003e",
"updateTimes": "1623192929,0,1623192929,0|625,344633291,625,349073249",
"usbstate": null,
"userInterfaceIdiom": 0,
"wifiip": null
},
"deviceRiskLabels": [
{
"label1": "monkey_device",
"label2": "monkey_game",
"label3": "b_monkey_game_apps",
"description": "机器操控设备:游戏操控:安装",
"timestamp": 1634732525000,
"detail": {
}
}
]
}

在线咨询