接口说明

本接口用于查询设备的风险画像信息。根据设备ID查询其设备类型、操作系统、品牌型号、风险标签、风险等级、最近风险行为等画像数据，帮助业务识别设备关联的风险。

鉴权说明

易盾智能风控服务使用签名认证方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5签名算法，详细信息请参见接口鉴权。

接入须知

控制接口调用频率，频率过快可能会被拒绝，拒绝后稍后重试即可。

 

设备画像查询接口请求说明

请求地址

名称	值
HTTP URL	http://ir-open.dun.163.com/v5/portrait/device/query
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："Content-Type:application/json"

请求参数

请求参数分为：公共参数，接口参数。其中，公共参数请见公共请求参数；接口参数如下：

参数	类型	必填	描述
businessId	String	是	业务编号
timestamp	Long	是	当前时间戳（毫秒）
nonce	String	是	随机字符串
version	String	是	版本号，固定值 "500"
secretId	String	是	密钥ID
signature	String	是	签名
deviceId	String	是	设备ID，最大长度128

请求参数示例

{
    "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
    "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp": ${currentTimeMs},
    "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
    "version": "500",
    "signature": "lll888f73yyy59440583zzz9bfcc79da",
    "deviceId": "device_abc123def456"
}

响应

响应结果

响应数据格式为：JSON。

响应头为：Content-Type:application/json，具体如下：

参数	类型	描述
code	Integer	响应码，正常情况下为200，异常时，见 附录响应码定义
msg	String	响应码说明，正常情况下返回"ok"，异常时，见 附录响应码定义
data	Object	返回data数据，设备画像信息，格式下表说明

返回data数据的格式：

参数	类型	说明
deviceId	String	传入原始值（设备ID）
deviceType	Integer	设备类型（真机、云真机、模拟器等）
osType	Integer	操作系统类型（1-Android, 2-iOS, 3-鸿蒙, 4-Windows, 5-Web, 6-小程序, 99-其他）
deviceBrand	String	设备品牌
deviceModel	String	设备型号
riskTags	List	风险标签列表，格式见下表
riskLevel	Integer	风险等级
riskScore	Double	风险分
recentTopRisks	List	最近风险行为，格式见下表

风险标签（riskTags）的格式：

参数	类型	说明
code	String	风险标签编码
name	String	风险名称

最近风险行为（recentTopRisks）的格式：

参数	类型	说明
name	String	风险名称
times	Integer	命中次数

响应结果示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "deviceId": "device_abc123def456",
        "deviceType": 1,
        "osType": 1,
        "deviceBrand": "Xiaomi",
        "deviceModel": "Mi 13",
        "riskTags": [
            {
                "code": "1240001",
                "name": "账号异常登录"
            },
            {
                "code": "124003",
                "name": "模拟器风险"
            }
        ],
        "riskLevel": 3,
        "riskScore": 88.0,
        "recentTopRisks": [
            {
                "name": "模拟器风险",
                "times": 10
            },
            {
                "name": "账号异常登录",
                "times": 2
            }
        ]
    },
    "ok": true
}

响应返回码

响应返回码见：响应返回码