数美天象产品API说明——风险手机号画像#

版权所有 翻版必究

风险手机号画像#

调用时机#

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

  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的内容如下：
请求参数名类型参数说明是否必传规范
phoneMd5string待查询的MD5加密的手机号phoneMd5、phoneSm3、phoneSha256不能同时为空该信息为客户要检测的手机号MD5加密（32位）
phoneSm3string待查询的SM3加密的手机号phoneMd5、phoneSm3、phoneSha256不能同时为空该信息为客户要检测的手机号SM3加密
phoneSha256string待查询的Sha256加密的手机号phoneMd5、phoneSm3、phoneSha256不能同时为空该信息为客户要检测的手机号Sha256加密
newCountryCodestring手机号国家码非必传参数该字符串规范为四位字符串，默认为中国手机号国家码0086，传入规范详见国家码与国家对应关系
typestring标签类型非必传参数手机号标签
可选值:
BLACKRECORDPHONE: 黑产手机号
SMSPLATFORMPHONE: 接码平台手机号
IOTSIMCARDPHONE: 物联网卡手机号
MVNOSIMCARDPHONE: 虚拟运营商手机号
RISKPHONE: 风险手机号
RELATERISKDEVICEPHONE: 手机号关联风险设备
RELATERISKTOKENPHONE: 手机号关联风险账号
TWOPHONE:手机号二次号
DEFAULT: 默认返回除"TWOPHONE"外的全部标签
支持传入多个一级风险标签以下划线_分隔
不传type参数默认返回除"TWOPHONE"外的全部标签
registerTimestampint64手机号的检查时间非必传，当type包含"TWOPHONE"的时候必传精确到小时（格式YYYYMMDDHH24）
例如：2017121200

返回结果#

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

参数名称参数类型参数说明是否必返规范
codeint返回码是1100：成功
1901：QPS超限
1902：参数不合法
1903：服务失败
1911：图片下载失败
9101：无权限操作
3000：运营商错误
除message和requestId之外的字段，只有当code为1100时才会存在
messagestring返回码描述是和code对应：成功 QPS超限 参数不合法 服务失败 余额不足 无权限操作
requestIdstring请求标识是请求唯一标识，用于排查问题和后续效果优化，强烈建议保存
phonePrimaryInfoJson_object手机号基础信息否见下面详情内容，仅在phoneMd5或phoneSm3传入时返回（不需要开通）
phoneRiskLabelsjson_array手机号风险标签否见下面详情内容，仅在phoneMd5或phoneSm3传入时返回（不需要开通）

其中 1）phonePrimaryInfo 的详情内容

返回结果参数名参数类型是否必反规范
phone_provincestring否归属省份
phone_citystring否归属城市
phone_operatorstring否运营商
intl_phone_countrylist否传入国家码对应全部国家列表

2）phoneRiskLabels的详情内容

返回结果参数名参数类型参数说明规范
label1string一级标签展示手机号风险标签的一级标签。
label2string二级标签展示手机号风险标签的二级标签。
label3string三级标签展示手机号风险标签的三级标签。
descriptionstring风险描述展示手机号风险标签的中文描述。
timestampint64最近一次命中策略的时间最近一次命中策略的时间
statusCodeint64中移动返回的查询状态仅在二次号手机号标签下返回，详见statusCode参数
detailjson_object证据描述证据细节

3）三级标签说明：

英文名（一级标签）中文名（一级标签）英文名（二级标签）中文名（二级标签）英文名（三级标签）中文名（三级标签）
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_pc_emulator_phonePC模拟器设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_cloud_device_phone云手机设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_phone_emulator_phone手机模拟器设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_altered_phone篡改设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_multi_boxing_by_os_phone系统多开设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_multi_boxing_by_app_phone工具多开设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_faker_phone伪造设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_farmer_phone农场设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_offerwall_phone积分墙设备手机号
relate_riskdevice_phone手机号关联风险设备fake_device_phone手机号关联虚假设备b_mismatch_phone参数不合法设备手机号
relate_riskdevice_phone手机号关联风险设备monkey_device_phone手机号关联机器操控设备b_monkey_apps_phone安装机器操控APP设备手机号
relate_riskdevice_phone手机号关联风险设备monkey_device_phone手机号关联机器操控设备b_webdriver_phone安装机器操控插件浏览器手机号
relate_riskdevice_phone手机号关联风险设备monkey_device_phone手机号关联机器操控设备b_monkey_game_apps_phone安装游戏操控APP设备手机号
relate_riskdevice_phone手机号关联风险设备monkey_device_phone手机号关联机器操控设备b_monkey_read_apps_phone安装资讯阅读APP设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_root_phoneROOT设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_sim_phone未插SIM卡设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_alter_apps_phone安装篡改APP手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_debuggable_phone调试模式设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_vpn_phoneVPN设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_hook_phone安装HOOK设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_manufacture_phone工程模式手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_wx_code_phone微信接码平台设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_sms_code_phone短信接码平台设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_low_osver_phone低操作系统版本设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_remote_control_apps_phone远程操控工具设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_repackage_phone重打包设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_console_phone开启控制台设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_reset_phone疑似重置设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_alter_loc_phone篡改地理位置设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_game_cheat_apps_phone安装游戏外挂工具设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_headless_phone无头浏览器设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_old_model_phone老旧设备手机号
relate_riskdevice_phone手机号关联风险设备suspicious_device_phone手机号关联可疑设备b_wangzhuan_active_phone网赚设备手机号
relate_risktoken_phone手机号关联风险账号risk_register_token_phone手机号关联风险注册账号monkey_register_token_phone机器注册手机号
relate_risktoken_phone手机号关联风险账号risk_login_token_phone手机号关联风险登录账号unusual_device_login_token_phone异常设备登录手机号
relate_risktoken_phone手机号关联风险账号risk_login_token_phone手机号关联风险登录账号unusual_region_login_token_phone异常地域登录手机号
relate_risktoken_phone手机号关联风险账号risk_login_token_phone手机号关联风险登录账号monkey_login_token_phone机器登录手机号
relate_risktoken_phone手机号关联风险账号marketing_cheating_token_phone手机号关联营销作弊账号fission_cheat_token_phone裂变作弊手机号
relate_risktoken_phone手机号关联风险账号marketing_cheating_token_phone手机号关联营销作弊账号rank_cheat_token_phone刷榜作弊手机号
relate_risktoken_phone手机号关联风险账号marketing_cheating_token_phone手机号关联营销作弊账号task_cheat_token_phone任务作弊手机号
relate_risktoken_phone手机号关联风险账号marketing_cheating_token_phone手机号关联营销作弊账号seckill_cheat_token_phone机器秒杀作弊手机号
relate_risktoken_phone手机号关联风险账号marketing_cheating_token_phone手机号关联营销作弊账号risk_discount_token_phone薅优惠手机号
relate_risktoken_phone手机号关联风险账号marketing_cheating_token_phone手机号关联营销作弊账号consume_stock_token_phone占库存/占座手机号
relate_risktoken_phone手机号关联风险账号data_stealing_token_phone手机号关联数据盗爬账号data_steal_token_phone数据盗爬手机号
relate_risktoken_phone手机号关联风险账号ad_scam_token_phone手机号关联诈骗导流账号net_scam_token_phone网络诈骗手机号
relate_risktoken_phone手机号关联风险账号ad_scam_token_phone手机号关联诈骗导流账号user_digging_token_phone竞品挖人手机号
relate_risktoken_phone手机号关联风险账号ad_scam_token_phone手机号关联诈骗导流账号ad_diversion_token_phone广告导流手机号
relate_risktoken_phone手机号关联风险账号risk_group_token_phone手机号关联高危团伙账号risk_group_token_phone高危团伙手机号
relate_risktoken_phone手机号关联风险账号risk_content_token_phone手机号关联风险内容账号porn_token_phone色情内容手机号
relate_risktoken_phone手机号关联风险账号risk_content_token_phone手机号关联风险内容账号politics_token_phone涉政内容手机号
relate_risktoken_phone手机号关联风险账号other_risk_token_phone手机号关联其他可疑账号monkey_token_phone机器操控手机号
relate_risktoken_phone手机号关联风险账号other_risk_token_phone手机号关联其他可疑账号high_frequency_token_phone异常高频手机号
relate_risktoken_phone手机号关联风险账号other_risk_token_phone手机号关联其他可疑账号abnormal_active_token_phone异常活跃手机号
relate_risktoken_phone手机号关联风险账号other_risk_token_phone手机号关联其他可疑账号discrete_region_token_phone地域离散手机号
relate_risktoken_phone手机号关联风险账号other_risk_token_phone手机号关联其他可疑账号abnormal_relation_token_phone异常关联手机号
black_record_phone黑产手机号black_record_phone黑产手机号black_record_phone黑产手机号
iot_simcard_phone物联网卡手机号iot_simcard_phone物联网卡手机号iot_simcard_phone物联网卡手机号
mvno_simcard_phone虚拟运营商手机号mvno_simcard_phone虚拟运营商手机号mvno_simcard_phone虚拟运营商手机号
sms_group_phone跑码群手机号sms_group_phone跑码群手机号sms_group_phone跑码群手机号
sms_platform_phone接码平台手机号sms_platform_phone接码平台手机号sms_platform_phone接码平台手机号
two_phone二次号手机号two_phone二次号手机号two_phone是二次号
two_phone二次号手机号two_phone二次号手机号phone_cancel销户手机号
two_phone二次号手机号two_phone二次号手机号unknown_phone未知手机号
two_phone二次号手机号two_phone二次号手机号normal_phone正常手机号
two_phone二次号手机号two_phone二次号手机号lookup_error查询失败
其中，中移动返回的查询编码：statusCode的内容如下：
返回编码编码说明
0正常
1读取XML失败，不是有效的数据流
2服务编码出错
201手机号码格式错误
206第三方接口超时或处理异常
5700电信二次号系统出错
5701联通二次号系统出错
5702号码非数字
5703非移动、电信、联通号码
5705手机号长度错误
104999未知运营商
104102手机号码错误
5610服务实例不存在
5502应用未配置能力
5503商品/能力状态不可用
5504商品未生效
5505商品失效
5506应用没有查到包含服务能力的可用商品实例
5507应用没有可用的商品余量
5615接口异常或者其他错误
5991调用第三方数据服务透传接口不通
5992请求体格式解析出错
5995传来的参数错误
5996ip鉴权没通过
5982apId 与 apKey 不匹配
5984Key过期
5986AES解密失败
5972appkey鉴权不通过
5981传递来的参数clientCode为空
5987clientCode长度不符，需为3-13位
5985系统失败
500调用失败

示例：#

请求示例：#

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

同步返回示例：#

{
"code": 1100,
"message": "成功",
"profileExist": 1,
"requestId": "7a5445716f0581c2ab1d381a6af4d1b8",
"phonePrimaryInfo": {
"phone_city": "鞍山",
"phone_operator": "移动",
"phone_province": "辽宁"
},
"phoneRiskLabels": [
{
"description": "接码平台手机号:接码平台手机号:接码平台手机号",
"label1": "sms_platform_phone",
"label2": "sms_platform_phone",
"label3": "sms_platform_phone",
"timestamp": null
},
{
"description": "物联网卡手机号:物联网卡手机号:物联网卡手机号",
"label1": "iot_simcard_phone",
"label2": "iot_simcard_phone",
"label3": "iot_simcard_phone",
"timestamp": null
},
{
"description": "虚拟运营商手机号:虚拟运营商手机号:虚拟运营商手机号",
"label1": "mvno_simcard_phone",
"label2": "mvno_simcard_phone",
"label3": "mvno_simcard_phone",
"timestamp": null
},
{
"description": "黑产手机号:黑产手机号:黑产手机号",
"label1": "black_record_phone",
"label2": "black_record_phone",
"label3": "black_record_phone",
"timestamp": null
}
]
}

附录： 国家码与国家对应关系表#

国家码(newCountryCode)国家(intl_phone_country)国家码(newCountryCode)国家(intl_phone_country)
0001['美国', '加拿大']0372['爱沙尼亚']
0007['俄罗斯', '哈萨克斯坦']0373['摩尔多瓦']
0020['埃及']0374['亚美尼亚']
0027['南非']0375['白俄罗斯']
0030['希腊']0376['安道尔']
0031['荷兰']0377['摩纳哥']
0032['比利时']0378['圣马力诺']
0033['法国']0379['梵蒂冈']
0034['西班牙']0380['乌克兰']
0036['匈牙利']0381['塞尔维亚']
0039['意大利']0382['黑山']
0040['罗马尼亚']0383['科索沃']
0041['瑞士']0385['克罗地亚']
0043['奥地利']0386['斯洛文尼亚']
0044['英国', '泽西岛', '马恩岛', '根西岛']0387['波黑']
0045['丹麦']0389['北马其顿']
0046['瑞典']0420['捷克']
0047['挪威', '斯瓦尔巴岛和扬马延岛']0421['斯洛伐克']
0048['波兰']0423['列支敦士登']
0049['德国']0500['福克兰群岛', '南乔治亚岛和南桑威奇群岛']
0051['秘鲁']0501['伯利兹']
0052['墨西哥']0502['危地马拉']
0053['古巴']0503['萨尔瓦多']
0054['阿根廷']0504['洪都拉斯']
0055['巴西']0505['尼加拉瓜']
0056['智利']0506['哥斯达黎加']
0057['哥伦比亚']0507['巴拿马']
0058['委内瑞拉']0508['圣皮埃尔和密克隆']
0060['马来西亚']0509['海地']
0061['澳大利亚', '赫德岛和麦克唐纳岛']0590['瓜德罗普', '圣巴泰勒米', '法属圣马丁']
0062['印尼', '印度尼西亚']0591['玻利维亚']
0063['菲律宾']0592['圭亚那']
0064['新西兰']0593['厄瓜多尔']
0065['新加坡']0594['法属圭亚那']
0066['泰国']0595['巴拉圭']
0081['日本']0596['马提尼克']
0082['韩国']0597['苏里南']
0084['越南']0598['乌拉圭']
0086['中国']0599['库拉索', '荷兰加勒比区', '荷属安的列斯']
0090['土耳其']0649['皮特凯恩']
0091['印度']0670['东帝汶']
0092['巴基斯坦']0673['文莱']
0093['阿富汗']0674['瑙鲁']
0094['斯里兰卡']0675['巴布亚新几内亚']
0095['缅甸']0676['汤加']
0098['伊朗']0677['所罗门群岛']
0210['西撒哈拉']0678['瓦努阿图']
0211['南苏丹']0679['斐济']
0212['摩洛哥']0680['帕劳']
0213['阿尔及利亚']0682['库克群岛']
0216['突尼斯']0683['纽埃']
0218['利比亚']0685['萨摩亚']
0220['冈比亚']0686['基里巴斯']
0221['塞内加尔']0687['新喀里多尼亚']
0222['毛里塔尼亚']0688['图瓦卢']
0223['马里']0689['法属波利尼西亚', '法属南部领地']
0224['几内亚']0690['托克劳']
0225['科特迪瓦']0691['密克罗尼西亚联邦']
0226['布基纳法索']0692['马绍尔群岛']
0227['尼日尔']0850['朝鲜']
0228['多哥']0852['中国']
0229['贝宁']0853['中国']
0230['毛里求斯']0855['柬埔寨']
0231['利比里亚']0856['老挝']
0232['塞拉利昂']0880['孟加拉国', '孟加拉']
0233['加纳']0886['中国']
0234['尼日利亚']0960['马尔代夫']
0235['乍得']0961['黎巴嫩']
0236['中非']0962['约旦']
0237['喀麦隆']0963['叙利亚']
0238['佛得角']0964['伊拉克']
0239['圣多美和普林西比']0965['科威特']
0240['赤道几内亚']0966['沙特阿拉伯']
0241['加蓬']0967['也门']
0242['刚果共和国', '刚果布']0968['阿曼']
0243['刚果民主共和国', '刚果金']0970['巴勒斯坦']
0244['安哥拉']0971['阿联酋']
0245['几内亚比绍']0972['以色列']
0246['英属印度洋领地']0973['巴林']
0248['塞舌尔']0974['卡塔尔']
0249['苏丹']0975['不丹']
0250['卢旺达']0976['蒙古']
0251['埃塞俄比亚']0977['尼泊尔']
0252['索马里']0992['塔吉克斯坦']
0253['吉布提']0993['土库曼斯坦']
0254['肯尼亚']0994['阿塞拜疆']
0255['坦桑尼亚']0995['格鲁吉亚']
0256['乌干达']0996['吉尔吉斯斯坦']
0257['布隆迪']0998['乌兹别克斯坦']
0258['莫桑比克']1242['巴哈马']
0260['赞比亚']1246['巴巴多斯']
0261['马达加斯加']1264['安圭拉']
0262['留尼汪']1268['安提瓜和巴布达']
0263['津巴布韦']1284['英属维尔京群岛']
0264['纳米比亚']1340['美属维尔京群岛']
0265['马拉维']1345['开曼群岛']
0266['莱索托']1441['百慕大']
0267['博茨瓦纳']1473['格林纳达']
0268['斯威士兰']1649['特克斯和凯科斯群岛']
0269['马约特', '科摩罗']1664['蒙塞拉特岛']
0290['圣赫勒拿']1670['北马里亚纳群岛']
0291['厄立特里亚']1671['关岛']
0297['阿鲁巴']1681['瓦利斯和富图纳']
0298['法罗群岛']1684['美属萨摩亚']
0299['格陵兰']1721['荷属圣马丁']
0350['直布罗陀']1758['圣卢西亚']
0351['葡萄牙']1767['多米尼克']
0352['卢森堡']1784['圣文森特和格林纳丁斯']
0353['爱尔兰']1787['波多黎各']
0354['冰岛']1809['多米尼加']
0355['阿尔巴尼亚']1868['特立尼达和多巴哥']
0356['马耳他']1869['圣基茨和尼维斯']
0357['塞浦路斯']1876['牙买加']
0358['芬兰', '奥兰']6721['南极洲']
0359['保加利亚']6722['科科斯（基林）群岛']
0370['立陶宛']6723['诺福克岛']
0371['拉脱维亚']6724['圣诞岛']
7天免费试用

  • 专属顾问全程服务

  • 个性化制定解决方案

  • 全天候响应问题随时解决

在线咨询

京公网安备 11010502032103号 | 京ICP备15044177号

Copyright©2015-2024 shumei All Rights Reserved