数美天象产品API接口说明文档#

设备风险画像#


版权所有 翻版必究


目录

天象风险识别#

调用时机#

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

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

天象数据流图#

企业微信截图_16825797212579

具体接口#

请求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生成必传通过前端调用getDeviceId()方法获取到的值传入

返回结果#

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

参数名称参数类型参数说明是否必返规范
codeint返回码1100:成功
1901:QPS超限
1902:参数不合法
1903:服务失败
9101:无权限操作
除message和requestId之外的字段,只有当code为1100时才会存在
messagestring返回码描述和code对应:成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作
requestIdstring请求标识请求唯一标识,用于排查问题和后续效果优化,强烈建议保存
profileExistint设备画像存在1:画像库中存在该设备信息0:画像库中不存在该设备信息
tokenLabelsjson_object账号标签信息见下面详情内容,仅在tokenId传入且服务开通时返回
deviceLabelsjson_object设备标签信息见下面详情内容,仅在deviceId传入且服务开通时返回
tokenProfileLabelsjson_object账号属性标签见下面详情内容,仅在tokenId传入且服务开通时返回
tokenRiskLabelsjson_object账号风险标签见下面详情内容,仅在tokenId传入且服务开通时返回
deviceRiskLabelsjson_object设备风险标签见下面详情内容,仅在deviceId传入且服务开通时返回
devicePrimayInfojson_object设备基础属性标签该服务需要单独开通,涉及到收费,如有需要请联系商务同学。该参数会返回开通后重新进行初始化上报的设备数据,仅支持查询近24小时内上报的设备数据。

其中

1)tokenLabels的详情内容

返回结果参数名参数类型参数说明规范
machine_account_riskjson_object机器控制相关风险
UGC_account_riskjson_objectUGC内容相关风险
scene_account_riskjson_object场景账号风险特殊场景才可取到,如航司等

machine_account_risk的详情内容如下:

返回结果参数名参数类型参数说明规范
b_machine_control_tokenidint机器账号0:非机器控制账号1:机器控制账号
b_machine_control_tokenid_last_tsint机器账号时间
b_offer_wall_tokenidint积分墙账号0:非积分墙账号1:积分墙账号
b_offer_wall_tokenid_last_tsint积分墙账号时间

UGC_account_risk的详情内容如下:

返回结果参数名参数类型参数说明规范
b_politics_risk_tokenidint涉政风险0:暂未发现涉政风险1:存在涉政风险
b_politics_risk_tokenid_last_tsint涉政风险时间
b_sexy_risk_tokenidint色情风险0:暂未发现色情风险1:存在色情风险
b_sexy_risk_tokenid_last_tsint色情风险时间
b_advertise_risk_tokenidint广告风险0:暂未发现广告风险1:存在广告风险
b_advertise_risk_tokenid_last_tsint广告风险时间

scene_account_risk的详情内容如下:

返回结果参数名参数类型参数说明规范
i_tout_risk_tokenidint航司占座账号0:非航司占座账号1:航司占座账号
i_tout_risk_tokenid_last_tsint航司占座时间

2)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_pc_idstringPC模拟器所在的PC设备id
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_appsint安装篡改工具设备安装篡改工具,如:应用变量,取值:
0:设备没有安装篡改工具
1:设备安装篡改工具
b_alter_apps_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位时间戳

other的详情内容如下:

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

device_suspicious_labels的详情内容如下:

返回结果参数名参数类型参数说明规范
b_rootintroot设备设备被root,取值:
0:设备未被root
1:设备被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:未使用VPN
1:使用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设备操作系统版本不小于9
1: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_low_activeint活跃时间过短活跃时间过短,取值:
0:不存在活跃时间小于6小时
1:存在活跃时间小于6小时
b_low_active_last_tsint活跃时间过短标签命中时间
b_idleint设备使用空间过少使用空间过少,取值:
0:不存在使用空间小于阈值
1:存在使用空间小于阈值
b_idle_last_tsint设备使用空间过少标签最近命中时间
b_old_modelint设备发布时间过早的老旧机型老旧型号,取值:
0:非老旧机型
1:是老旧机型
b_old_model_last_tsint设备发布时间过早标签最近命中时间
b_non_appstoreint非官方渠道安装APP非官方渠道安装APP,取值:
0:是官方渠道安装APP
1:不是官方渠道安装APP
b_non_appstore_last_tsint非官方渠道安装APP标签最近命中时间
b_wangzhuan_activeint网赚平台活跃设备网赚平台活跃设备,取值
0:未在网赚平台活跃
1:在网赚平台活跃
b_wangzhuan_active_countint网赚平台活跃次数该设备在网赚平台的特定周期内活跃次数的累加值
b_wangzhuan_active_last_tsint网赚平台活跃设备标签最近命中时间
b_malware_installedjson_object返回风险应用的应用名风险应用的应用列表,示例: vmos、virtualapp、redfinger等
b_device_proxyint设备使用代理该设备当前在使用代理服务,取值:
0:未使用代理,
1:使用代理模式
b_device_proxy_last_tsint设备使用代理最近标签命中时间
b_camera_hookint当前设备存在摄像头被劫持风险当前设备存在摄像头被劫持风险,取值:
0:摄像头未被劫持,
1:摄像头被劫持
b_camera_hook_last_tsint设当前设备存在摄像头被劫持标签命中时间
b_adb_enableint当前设备存在开启adb调试模式风险当前设备存在开启adb调试模式风险,取值:
0:未开启adb调试模式,
1:开启了adb调试
b_adb_enable_last_tsint当前设备存命中开启adb调试模式风险的时间

device_active_info的详情内容如下:

返回结果参数名参数类型参数说明规范
i_smid_boot_timestampint系统启动时间
b_active_timehint设备启动到当前的小时数,仅记录24小时内的活跃时间,超过24小时候之后,设备没有重启之前,值不会再更新;
b_active_timeh_last_tsint最近一次写入设备启动当当前小时数值的时间;
b_model_release_timestampint设备型号的工信部入网时间或公开发布时间;
b_usespacegint设备已用的磁盘空间,仅记录20G以内的数据;
b_usespaceg_last_tsint设备易用磁盘空间最近一次入值的时间;
b_device_first_activationint设备是否首次出现,取值:
0:非首次出现
1:首次出现
b_device_first_activation_tsint设备首次出现时间

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资讯阅读工具时间

其中标签类返回字段

1)tokenProfileLabels的详情内容

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

2)tokenRiskLabels的详情内容

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

3)deviceRiskLabels的详情内容

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

4)devicePrimayInfo的详情内容(设备基础属性标签)

标签名称返回字段
辅助服务信息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

示例:#

请求示例:#

{
"accessKey": "xxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"deviceId": "ceshideviceId"
}
}

返回示例:#

{
"code": 1100,
"message": "成功",
"profileExist": 1,
"requestId": "7a5445716f0581c2ab1d381a6af4d1b8",
"tokenLabels": {
"machine_account_risk": {
"b_machine_control_tokenid": 1,
"b_machine_control_tokenid_last_ts": 1587711321232,
"b_offer_wall_tokenid": 1,
"b_offer_wall_tokenid_last_ts": 1587711321232
},
"UGC_account_risk": {
"b_politics_risk_tokenid": 1,
"b_politics_risk_tokenid_last_ts": 1587711321232,
"b_sexy_risk_tokenid": 1,
"b_sexy_risk_tokenid_last_ts": 1587711321232,
"b_advertise_risk_tokenid": 1,
"b_advertise_risk_tokenid_last_ts": 1587711321232
},
"scene_account_risk": {
"i_tout_risk_tokenid": 1,
"i_tout_risk_tokenid_last_ts": 1587711321232
},
"account_active_info": {
"i_tokenid_first_active_timestamp": 1587711321232,
"i_tokenid_active_days_7d": 5,
"i_tokenid_active_days_4w": 5
},
"account_freq_info": {
"i_tokenid_login_cnt_1d": 5,
"i_tokenid_login_cnt_7d": 5
},
"account_relate_info": {
"i_tokenid_relate_smid_cnt_1d": 5,
"i_tokenid_relate_smid_cnt_7d": 5,
"i_tokenid_relate_ip_city_cnt_1d": 5,
"i_tokenid_relate_ip_city_cnt_7d": 5
},
"account_common_info": {
"s_tokenid_relate_smid_info_map_4w": [
{
"smid": "xxxx1",
"days": "3"
},
{
"smid": "xxxx2",
"days": "5"
},
{
"smid": "xxxx3",
"days": "10"
}
],
"s_tokenid_relate_ip_city_info_map_4w": [
{
"city": "北京",
"days": "3"
},
{
"city": "长沙",
"days": "5"
},
{
"city": "武汉",
"days": "10"
}
]
}
},
"deviceLabels": {
"id": 123,
"fake_device": {
"b_pc_emulator": 1,
"b_pc_emulator_last_ts": 1587711321232,
"b_pc_emulator_pc_id": "Tl1mP4Esna9Mph16LZO40CeARG7f9ZNy",
"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,
"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_repackage_last_ts": 1587711321232
},
"device_active_info": {
"i_smid_boot_timestamp": 1587711321232
},
"monkey_device": {
"common": {
"b_monkey_apps": 0,
"b_monkey_apps_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
}
}
},
"tokenProfileLabels": [
{
"label1": "age_gender",
"lable2": "token_age",
"label3": "minor_token",
"description": "年龄性别:年龄:未成年人",
"timestamp": 1634732525000,
"detail": {
}
}
],
"tokenRiskLabels": [
{
"label1": "risk_device_token",
"label2": "b_cloud_token_device",
"label3": "b_cloud_token_device",
"description": "风险设备账号:云手机账号:云手机账号",
"timestamp": 1634732525000,
"detail": {
}
},
{
"label1": "risk_device_token",
"label2": "b_hook_token",
"label3": "b_hook_token",
"description": "风险设备账号:hook设备:hook设备",
"timestamp": 1634732525000,
"detail": {
}
}
],
"deviceRiskLabels": [
{
"label1": "monkey_device",
"label2": "monkey_game",
"label3": "b_monkey_game_apps",
"description": "机器操控设备:游戏操控:安装",
"timestamp": 1634732525000,
"detail": {
}
}
]
}

在线咨询