2.IP盾api接入说明

IP盾提供IP检测服务，用户可通过“无胁安全”创建符合自身业务需求的api，提供了多个场景可依据自身业务灵活选择。IP盾依靠无胁科技对黑灰产的监控及威胁情报的搜集和分析能力，每天可以实时监测到黑灰产代理IP达百万级，这些IP资源主要用于扫描、批量注册、爬虫、撞库攻击、刷单刷量、群控代理、使用大量随机IP地址来绕过安全风控策略。通过独有的评分算法为这些黑灰产代理IP实现多维度评定分数，用户可直观的通过分数来鉴别威胁级别。

调用方法

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

请求方法： GET或POST

返回类型： JSON

请求参数：

参数名 类型 是否必选 描述
Appkey String 是 用户appkey，请到无胁安全（接口管理）查看
Token String 是 api token，请到无胁安全（接口管理）查看
Secne String 是 api场景（需传入场景ID），请到无胁安全（接口管理）查看
IP String 是 IP地址

请求示例：https://apitj-bj.wuthreat.com/ip/search?Appkey=用户appkey&Token=api token&Secne=api场景ID&IP=IP地址

返回参数：

  • 正常返回：

    例：{"ip": "1.180.13.77", #IP地址
"time": "2020-02-02 00:00:00",  #发现时间
"isp": "电信",  #运营商
"country": "中国",  #国家
"province": "内蒙古",  #省份
"city": "呼和浩特",  #城市
"risk": 95.5,  #风险分值
"risk_tag": ["代理"，"恶意注册"],  #风险标签
"history": #历史记录（显示三十天之内的前十条记录）
[{"ip": "1.180.13.77", 
"time": "2020-01-31 10:12:50", 
"risk": 90},
{"ip": "1.180.13.77", 
"time": "2020-01-04 10:10:50", 
"risk": 88}
]}

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

错误返回：

	{"error_code": 1001,"error": "appkey错误"}
	{"error_code": 1002,"error": "token错误"}
	{"error_code": 1003,"error": "未创建此场景接口"}
	{"error_code": 1004,"error": "您尚未拥有此产品的查询权限"}
	{"error_code": 1005,"error": "ip地址有误,仅支持IPv4地址"}
	{"error_code": 1006,"error": "ip地址有误"}
	{"error_code": 1007,"error": "您的产品剩余次数不足"}
	{"error_code": 1010,"error": "请把当前IP:*.*.*.*;加入白名单"}
	{"error_code": 1099,"error": "传入参数名错误"}