IP风险画像事件及返回参数_API及SDK

服务事件参数

服务事件参数是指公共参数中，ServiceParameters字段的传参，格式为json格式，以下为IP风险画像-事件参数。

字段名称	字段描述	数据格式	样例数据	是否必须
ip	需要分析的IPv4地址。	String	42.120.74.211	必传

个性化返回参数

个性化返回参数，除公共返回参数外，IP风险画像服务返回参数Data字段中，score 字段值的业务含义根据阿里云风控团队经验可参考如下（实际使用可根据自身业务运营灵活选择）：

IP风险画像返回的Data参数中的score值，值区间在0~1之间，值越大代表行为的风险程度越大。

值区间	风险等级
0	低风险
0到0.35	中风险
0.35到0.5	中高风险
0.5到1	高风险

IP风险画像返回的Extend数据中的值及对象内容释义。Extend数据格式为json格式。

值	内容释义
country	国家或地区名称，中文。例如，“中国”。
province	省级名称，中文。例如，“浙江”
city	城市名称，中文。例如，“杭州”
isIdc	是否是IDC机房IP。1代表是，0代表不是。
isProxy	是否是代理IP。1代表是，0代表不是。
isNat	是否是NAT IP。1代表是，0代表不是。
isBase	是否是基站IP。1代表是，0代表不是。

IP风险画像服务的json示例：

{
    "Data": {
        "score": 0.35, //0到1分得风险分数，double格式
        "extend": "{\"country\":\"泰国\",\"province\":\"\",\"city\":\"\",\"isIdc\":\"0\",\"isProxy\":\"0\",\"isNat\":\"0\",\"isBase\":\"0\"}"//拓展字段
    },
    "Message": "OK",
    "Code": 200, //200表示请求成功
    "RequestId":"4EF9AEE5-288F-4176-8110-00EDC91A614E"
}