加载接口文档…
130
累计调用
546ms
平均响应
100.00%
服务可用性
200 次/日
免费额度
访问限制
查看更多方案 →
文档链接
复制文档地址
https://apizero.cn/aidocs/risk-score/raw.md接口请求地址
https://v1.apizero.cn/api/risk-score
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/risk-score
接口信息备注
需要 API Key（涉及用户隐私数据，不开放匿名调用）。登录用户每日 20 次免费。mobile / ip / email 至少传一项。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| mobile | string | 可选 · 手机号（11 位手机号或 13 位物联网卡号），识别虚拟运营商/物联网卡 · 示例：17012345678 |
| ip | string | 可选 · IPv4/IPv6 地址；传 self 检测调用者自身 IP · 示例：47.88.1.1 |
| string | 可选 · 邮箱地址，识别临时邮箱/MX/本地异常 · 示例：abc@guerrillamail.com | |
| scene | string | 可选 · 业务场景 register/login/order/coupon，默认 register · 示例：register |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| risk_score | int | 综合风险分 0~100，越高越危险 |
| risk_level | string | safe / low / medium / high / critical |
| decision | string | 决策建议：pass(放行) / review(二次验证) / reject(拦截) |
| checked | object | {mobile,ip,email} 各维度是否参与评估 |
| hit_rules | array | 命中的风险规则 [{code,weight,desc}] |
| signals | object | 各维度明细 {mobile,ip,email} |
| scene | string | 回传业务场景 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"risk_score": 88,
"risk_level": "critical",
"decision": "reject",
"checked": {
"mobile": true,
"ip": true,
"email": true
},
"hit_rules": [
{
"code": "MOBILE_MVNO",
"weight": 35,
"desc": "虚拟运营商号段（170），实名宽松，薅羊毛高发"
},
{
"code": "EMAIL_DISPOSABLE",
"weight": 35,
"desc": "一次性/临时邮箱域名，典型用于注册套利"
},
{
"code": "IP_DATACENTER",
"weight": 30,
"desc": "机房/IDC IP（非真实用户网络，脚本批量常用）"
}
],
"signals": {
"mobile": {
"checked": true,
"input_mask": "170****5678",
"valid": true,
"number_type": "mvno",
"carrier": "虚拟运营商",
"risk": "high"
},
"email": {
"checked": true,
"email": "abc@guerrillamail.com",
"valid_format": true,
"is_disposable": true,
"is_trusted": false,
"has_mx": true,
"risk": "high"
},
"ip": {
"checked": true,
"ip": "47.88.x.x",
"valid": true,
"is_private": false,
"is_proxy": false,
"is_datacenter": true,
"province": "",
"isp": "阿里云",
"risk": "medium"
}
},
"scene": "register"
},
"request_id": "k9x2p4mabc12",
"tips": "极数本源 · https://apizero.cn"
}免责声明
风险分基于号段规则、IP 情报与邮箱特征综合计算，为辅助决策参考，不构成对个人身份的法律结论；最终处置请结合自身业务规则与人工复核。