接口说明

该接口用于请求IP风险画像结果数据。批量接口一次可请求多个IP的风险画像结果。支持http协议接口调用。

鉴权说明

易盾内容安全服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求地址

名称	值
HTTP URL	https://rp.dun.163.com/v1/profile/ip/multiple/query
HTTP Method	POST

请求

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由公共参数和业务参数两部分组成，公共参数见请求公共参数

名称	类型	必填	最大长度	描述
version	String	是	4	接口版本号，可选值 v1
ips	List	是	100	查询IP，每次最多查询100个IP

请求体示例

version=v1&nonce=xxx&timestamp=xxx&signature=xxx&secretId=xxx&businessId=xxx&ips=xxx

响应

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段：

名称	类型	必填	描述
data	Object	是	查询结果
-success	Boolean	是	是否查询成功
-taskId	String	是	查询的唯一标识
-riskDetails	Object[]	是	风险详情
-ip	String	是	检测IP
-riskInfoList	Object[]	是	风险信息
-riskLevel	int	是	风险等级，0-低风险，1-中风险，2-高风险
-riskType	int	是	风险类型：13001-恶意引流、13002-真人欺诈、13003-团伙设备聚集
-riskScore	int	是	风险分值：0~1
-propDetails	Object	否	属性详情
-location	Object	否	IP归属地信息
-isp	String	否	运营商
-continent	String	否	大洲
-country	String	否	国家
-province	String	否	省份
-city	String	否	城市
-longitude	String	否	经度
-latitude	String	否	纬度

响应体示例

{
    "code":200,
    "msg":"成功",
    "data":{
        "riskDetails":[
            {
                "riskInfoList":[
                    {
                      "riskLevel":1,
                      "riskType":11002,
                      "riskScore":0.6
                    },
                    {
                      "riskLevel":2,
                      "riskType":11001,
                      "riskScore":0.4
                    }
                ],
                "propDetails":{
                     "location":{
                        "continent":"亚洲",
                        "country":"中国",
                        "province":"广东",
                        "city":"珠海",
                        "isp":"电信",
                        "latitude":"22.253989",
                        "longitude":"113.550829"
                    }
                },
                "ip":"1.2.3.4"
            },
            {
                "riskInfoList":[
                    {
                      "riskLevel":2,
                      "riskType":11001,
                      "riskScore":0.4
                    }
                ],
                "propDetails":{
                     "location":{
                        "continent":"亚洲",
                        "country":"中国",
                        "province":"广东",
                        "city":"珠海",
                        "isp":"电信",
                        "latitude":"22.253989",
                        "longitude":"113.550829"
                    }
                },
                "ip":"1.2.3.5"
            }
        ],
        "success":true,
        "taskId":"12912d9a88e8497ab5f88fc3e8e82216"
    }
}

接入示例代码

开发工具集（SDK）接入

为方便 JAVA 开发者调试和接入API，我们提供了配套的开发工具集（SDK），用于简化API接入流程。SDK中各接口调用方式基本相同，接入方式统一，并提供了一些接口调用过程中常见的异常处理方案。以下介绍了SDK的使用流程，以及使用SDK的简单示例。

• 准备工作

准备步骤详见通用步骤

• 使用方法

该接口的使用方法可参考SDK demo