接口说明

本接口用于查询手机号的风险画像信息。根据手机号查询其运营商归属地、风险标签、风险等级、最近风险行为等画像数据，帮助业务识别手机号关联的风险。

鉴权说明

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

接入须知

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

 

手机画像查询接口请求说明

请求地址

名称	值
HTTP URL	http://ir-open.dun.163.com/v5/portrait/phone/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	是	签名
phone	String	是	手机号，最大长度32

请求参数示例

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

响应

响应结果

响应数据格式为：JSON。

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

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

返回data数据的格式：

参数	类型	说明
phone	String	传入原始值（手机号）
operator	String	运营商
location	Object	归属地信息，格式见下表
riskTags	List	风险标签列表，格式见下表
riskLevel	Integer	风险等级
riskScore	Double	风险分
recentTopRisks	List	最近风险行为，格式见下表
smsPlatform	Integer	是否接码平台号码（0-不是, 1-是），仅当业务已开通“接码平台”能力时返回。
phoneStatus	Integer	号码状态。-1：未知；0：正常使用；1：停机；2：在网但不可用；3：不在网、销号、未启用或号码异常；4：预销户；5：虚拟号或号码错误；6：查无记录（号码已被收回或从未放出）；7：数据源异常，建议重试；8：号码频繁使用（24小时内超过15次）。仅当业务已开通“号码状态”能力时返回。

归属地信息（location）的格式：

参数	类型	说明
country	String	归属地国家
province	String	归属地省份
city	String	归属地城市
district	String	归属地区县
continent	String	归属地大洲

风险标签（riskTags）的格式：

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

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

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

响应结果示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "phone": "13800138000",
        "operator": "中国移动",
        "location": {
            "country": "中国",
            "province": "浙江省",
            "city": "杭州市",
            "district": "西湖区",
            "continent": "亚洲"
        },
        "riskTags": [
            {
                "code": "1240001",
                "name": "账号异常登录"
            },
            {
                "code": "124002",
                "name": "恶意刷单"
            }
        ],
        "riskLevel": 2,
        "riskScore": 75.5,
        "recentTopRisks": [
            {
                "name": "账号异常登录",
                "times": 3
            }
        ],
        "smsPlatform": 0,
        "phoneStatus": 1
    },
    "ok": true
}

响应返回码

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