广告设备价值/风险评分查询接口用于查询指定广告设备的价值评分与风险评分。

接口说明

鉴权说明

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

结果说明

• 协议说明：接口支持HTTPS协议，支持POST方法，传输数据格式为JSON，编码采用utf-8

请求说明

请求地址

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

请求头

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

请求参数

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

参数	类型	必填	描述
adId	String	是	广告唯一标识，最大长度128字符

请求示例

{
    "businessId": "a0bcmo3aa617x1n62tlhtragdd009wy1",
    "secretId": "b0bcmo3aa617x1n62tlhtragdd009wy2",
    "timestamp": 1701837991081,
    "nonce": "c0bcmo3aa617x1n62tlhtragdd009wy3",
    "version": "500",
    "signature": "d0bcmo3aa617x1n62tlhtragdd009wy4",
    "adId": "adId001"
}

响应

响应结果

响应数据格式为：JSON。

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

参数	类型	描述
code	Integer	响应码，正常情况下为200，异常时，见 附录响应码定义
msg	String	响应码说明，正常情况下返回"成功"，异常时，见 附录响应码定义
ok	Boolean	请求是否成功，true=成功
desc	String	响应信息描述，非必返，常见错误情况下会返回错误说明或错误参考文档
data	JSONObject	返回数据，格式见下表

返回数据的格式：

参数	类型	描述
riskScore	Double	风险分，取值范围 0~1；无数据时该字段不返回，请注意判空处理
deviceValueScore	Integer	设备价值分，取值范围 0~100；无数据时该字段不返回，请注意判空处理
modelScore	Double	设备模型分，用于衡量设备综合价值，取值范围 0~100；无数据时该字段不返回，请注意判空处理

响应示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "riskScore": 0.85,
        "deviceValueScore": 62,
        "modelScore": 13.06
    },
    "ok": true
}

响应返回码

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