1.注册盾api接入说明

注册盾提供手机号和IP检测服务，用户可通过“无胁安全”创建符合自身业务需求的api，提供了多个场景可依据自身业务灵活选择。注册盾依靠无胁科技强大的黑灰产情报搜集能力及渠道合作伙伴的数据能力，每天更新有效黑卡手机号数据量近 10 万条，各类手机号黑卡数据累计数千万条。IP每天可以实时监测到黑灰产代理IP数据量达百万级。通过独有的评分算法为这些黑卡手机号、黑灰产代理IP实现多维度评定分数，用户可直观的通过分数来鉴别威胁级别。

调用方法

调用地址： https://apitj-bj.wuthreat.com/phone/search

请求方法： GET或POST

返回类型： JSON

请求参数：

参数名 类型 是否必选 描述
Appkey String 是 用户appkey，请到无胁安全（接口管理）查看
Token String 是 api token，请到无胁安全（接口管理）查看
Secne String 是 api场景（需传入场景ID），请到无胁安全（接口管理）查看
Num String 是 手机号（如查询国外手机号，前缀需加”+”号和国际代码，如：+19494501234）；或手机号MD5加密值，MD5格式： 32位、小写字母。如使用MD5加密查询则返回值phone_num也是MD5加密值。
IP String 是 IP地址

请求提示：

  • 手机号明文查询：https://apitj-bj.wuthreat.com/phone/search?Appkey=用户appkey&Token=api_token&Secne=api场景ID&Num=13800138000&IP=IP地址

  • 手机号MD5加密查询：https://apitj-bj.wuthreat.com/phone/search?Appkey=用户appkey&Token=api_token&Secne=api场景ID&Num=098f6bcd4621d373cade4e832627b4f6&IP=IP地址

返回参数：

  • 手机号明文查询：

    例：{
	"phone": { #手机号信息
	"phone_num": "13800138000", #手机号
	"type": "virtual", #手机号类别（public：公共号，virtual：虚拟号，iot：物联网号）
	"isp": "虚拟/移动", #一级运营商
	"isp1": "分享通信", #二级运营商
	"frist_time": "2019-09-01 00:00:00", #首次发现时间
	"last_time": "2020-02-02 00:00:00", #最后一次发现时间
	"country": "中国", #国家
	"province": "安徽", #省份
	"city": "阜阳", #城市
	"risk": 99, #风险分值
	"risk_tag": ""}, #风险标签
	"ip": { #IP信息
	"ip": "1.180.13.77", #IP地址
	"time": "2020-01-30 00:00:00", #发现时间
	"isp": "电信", #运营商
	"country": "中国", #国家
	"province": "内蒙古", #省份
	"city": "呼和浩特", #城市
	"risk": 95.5, #风险分值
	"risk_tag": ["代理"，"恶意注册"]，#风险标签
	"history": #历史记录（显示三十天之内的前十条记录）
	[{"ip": "1.180.13.77", 
	"time": "2020-01-20 10:12:50", 
	"risk": 90}
	}]
	}

  • 手机号MD5加密查询正常返回：

    例：{
	"phone": { #手机号信息
	"phone_num": "098f6bcd4621d373cade4e832627b4f6", #手机号MD5加密值
	"type": "virtual", #手机号类别（public：公共号，virtual：虚拟号，iot：物联网号）
	"isp": "虚拟/移动", #一级运营商
	"isp1": "分享通信", #二级运营商
	"frist_time": "2019-09-01 00:00:00", #首次发现时间
	"last_time": "2020-02-02 00:00:00", #最后一次发现时间
	"country": "中国", #国家
	"province": "安徽", #省份
	"city": "阜阳", #城市
	"risk": 99, #风险分值
	"risk_tag": ""}, #风险标签
	"ip": { #IP信息
	"ip": "1.180.13.77", #IP地址
	"time": "2020-01-30 00:00:00", #发现时间
	"isp": "电信", #运营商
	"country": "中国", #国家
	"province": "内蒙古", #省份
	"city": "呼和浩特", #城市
	"risk": 95.5, #风险分值
	"risk_tag": ["代理"，"恶意注册"]，#风险标签
	"history": #历史记录（显示三十天之内的前十条记录）
	[{"ip": "1.180.13.77", 
	"time": "2020-01-20 10:12:50", 
	"risk": 90}
	}]
	}

注：如risk字段风险分值为0，则此手机号或IP属于非风险手机号或IP，此时只显示手机号或IP的基本信息。

错误返回：

	{"error_code": 2001,"error": "appkey错误"}
	{"error_code": 2002,"error": "token错误"}
	{"error_code": 2003,"error": "未创建此场景接口"}
	{"error_code": 2004,"error": "您尚未拥有此产品的查询权限"}
	{"error_code": 2005,"error": "ip地址有误,仅支持IPv4地址"}
	{"error_code": 2006,"error": "ip地址有误"}
	{"error_code": 2007,"error": "您的产品剩余次数不足"}
	{"error_code": 2008,"error": "您输入的号码不正确，请核实号码"}
	{"error_code": 2010,"error": "请把当前IP:*.*.*.*;加入白名单"}
	{"error_code": 2099,"error": "传入参数名错误"}