
API接口
接口地址:https://api.ipplus360.com/ip/info/v3/portrait/
请求方式:HTTPS GET/POST
请求示例:https://api.ipplus360.com/ip/info/v3/portrait/?key=您申请的KEY&ip=您需要查询的ip&coordsys=WGS84
调用工具:「「去调试」」(https://mall.ipplus360.com/pros/APIDebug?type=8)

请求参数
| 名称
|
必填
|
类型
|
示例值
|
描述
|
| key
|
是
|
String
|
|
您申请的key
|
| ip
|
是
|
String
|
120.53.244.89
|
查询的IP
|
| coordsys
|
否
|
String
|
WGS84
|
坐标系,分为WGS84和BD09,默认为WGS84
|

返回参数
| 名称
|
类型
|
示例值
|
描述
|
| code
|
String
|
Success
|
状态码
|
| data.tag
|
String
|
IDC
|
风险标签
Proxy:该IP被捕获到被当做代理IP来使用
VPN:该IP被捕获到被当做VPN IP来使用
Sec_Dial:该IP被捕获到被当做秒拨IP来使用
IDC:该IP被识别为数据中心机房IP
Tor:该IP被捕获到被当做Tor节点来使用
Scan:该IP被捕获到有端口扫描行为
Brute_Force:该IP被捕获到有暴力破解行为
|
| data.updatetime
|
String
|
2023-06-19 11:42:45
|
风险捕获时间
时间格式:2023-06-19 11:42:45
|
| data.level
|
String
|
高
|
风险等级
高:根据业务需求进行拦截或标记、触发严格验证,推荐较高强度的风控处理手段
中:推荐中等强度,对用户体验影响较小的风控手段
低:推荐较弱强度,对用户体验无影响的风控处理,或对相关账号进行标记
无:建议放行,不做处理
|
| data.score
|
Int
|
80
|
风险分数 分值范围:0-100
|
| data.continent
|
String
|
亚洲
|
大洲
|
| data.country
|
String
|
中国
|
国家
|
| data.prov
|
String
|
北京市
|
省份
|
| data.city
|
String
|
北京市
|
城市
|
| data.district
|
String
|
东城区
|
区县
|
| data.lat
|
String
|
39.902798
|
纬度
|
| data.lng
|
String
|
116.401159
|
经度
|
| data.radius
|
String
|
105.2321
|
定位半径(km)
|
| data.areacode
|
String
|
CN
|
国家编码
|
| data.owner
|
String
|
腾讯
|
所属机构
|
| data.isp
|
String
|
腾讯
|
运营商
|
| data.scene
|
String
|
数据中心
|
使用场景
|
| charge
|
Boolean
|
true
|
本次查询是否扣费
|
| msg
|
String
|
查询成功
|
状态码描述
|
| ip
|
String
|
120.53.244.89
|
查询的IP
|
| coordsys
|
String
|
WGS84
|
坐标系
|
若数据查空:tag和updatetime为空字符串,level值为无,score值为0

状态码描述
| HTTP状态码
|
业务状态码
|
描述
|
| 200
|
Success
|
查询成功
|
| 200
|
NoData
|
查询成功,但是结果为空
|
| 400
|
MissingParameter
|
参数key缺失
|
| 400
|
MissingParameter
|
参数ip缺失
|
| 400
|
InvalidParameter
|
参数ip格式不对
|
| 400
|
DailyLimited
|
每日查询次数已满
|
| 429
|
Throttling
|
请求过快
|
| 400
|
UnknownError
|
客户端未知错误
|
| 403
|
KeyNotFound
|
key不存在
|
| 403
|
KeyUnauthorized
|
key未授权
|
| 403
|
KeyExpired
|
不在有效期
|
| 403
|
KeyNotEnoughBalance
|
余额不足
|
| 403
|
KeyDisabled
|
key被禁用
|
| 500
|
InternalError
|
服务器内部错误
|
| 503
|
ServiceUnavailable
|
服务器临时错误
|

返回示例值
{
"code": "Success",
"data": {
"tag": "IDC",
"updatetime": "2023-06-19 11:42:45",
"level": "高",
"score": 80,
"continent": "亚洲",
"country": "中国",
"areacode": "CN",
"prov": "北京市",
"city": "北京市",
"district": "",
"lng": "116.401159",
"lat": "39.902798",
"radius": "105.2321",
"isp": "腾讯",
"owner": "腾讯",
"scene": "数据中心"
},
"ip": "120.53.244.89",
"charge": true,
"msg": "查询成功",
"coordsys": "WGS84"
}

应用领域
防止误杀
识别移动网络、WLAN、IDC等场景下的用户,防止对正常用户做出失误判断,影响营销效果。
用户体验提升
针对不同场景下的用户推送符合用户特征的活动或信息。如企业专线和学校单位下的用户可推送不同类型的产品。
真人识别
通过对数据中心、交换中心、基础设施等场景的识别,判断访客是否为爬虫、VPN代理或羊毛党。
校验位置可信度
通过对多类别场景识别与网络位置精度分析,判断用户位置的可信程度。