综合风控评分

risk-scorePOST
POSThttps://v1.apizero.cn/api/risk-score
获取 API Key工作台购买 / 调试

概述

输入手机号 / IP / 邮箱，秒级输出 0~100 风险分与放行/二次验证/拦截建议，专治注册薅羊毛、批量养号、营销作弊。三维信号：手机号识别虚拟运营商与物联网卡号段，IP 识别代理/VPN/机房与风险分，邮箱识别临时邮箱与 MX 异常。一次调用拿到可直接用于业务决策的结论。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/risk-score/raw.md
打开 Markdown

鉴权

需要 API Key（涉及用户隐私数据，不开放匿名调用）。登录用户每日 20 次免费。mobile / ip / email 至少传一项。

获取 API Key

请求头

Authorizationstring必填

必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

请求参数

POST · APPLICATION/JSON

mobile（手机号）string选填

手机号（11 位手机号或 13 位物联网卡号），识别虚拟运营商/物联网卡

例17012345678

ip（IP）string选填

IPv4/IPv6 地址；传 self 检测调用者自身 IP

例47.88.1.1

email（邮箱）string选填

邮箱地址，识别临时邮箱/MX/本地异常

例abc@guerrillamail.com

scenestring选填

业务场景 register/login/order/coupon，默认 register

例register

{
  "mobile": "17012345678",
  "ip": "47.88.1.1",
  "email": "abc@guerrillamail.com",
  "scene": "register"
}

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

risk_scoreint

综合风险分 0~100，越高越危险

risk_levelstring

safe / low / medium / high / critical

decisionstring

决策建议：pass(放行) / review(二次验证) / reject(拦截)

checkedobject

{mobile,ip,email} 各维度是否参与评估

mobileboolean

mobile

ipboolean

ip

emailboolean

email

hit_rulesarray

命中的风险规则 [{code,weight,desc}]

codestring

代码

weightnumber

weight

descstring

说明

signalsobject

各维度明细 {mobile,ip,email}

mobileobject

mobile

checkedboolean

checked

input_maskstring

input_mask

validboolean

valid

number_typestring

number_type

carrierstring

carrier

riskstring

risk

emailobject

email

checkedboolean

checked

emailstring

email

valid_formatboolean

valid_format

is_disposableboolean

is_disposable

is_trustedboolean

is_trusted

has_mxboolean

has_mx

riskstring

risk

ipobject

ip

checkedboolean

checked

ipstring

ip

validboolean

valid

is_privateboolean

is_private

is_proxyboolean

is_proxy

is_datacenterboolean

is_datacenter

provincestring

province

ispstring

isp

riskstring

risk

scenestring

回传业务场景

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/risk-score" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mobile": "17012345678",
  "ip": "47.88.1.1",
  "email": "abc@guerrillamail.com",
  "scene": "register"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
按次付费 · 点数包
QPS 限制
QPS 2
登录免费额度
200 次（已认证）
匿名每日额度
10 次（无 API Key）
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
本接口约 49,875 次/月 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-05-29

    首次上线：手机号（虚拟运营商/物联网卡）+ IP（代理/机房/风险分）+ 邮箱（临时邮箱/MX）三维综合风控评分

免责声明

风险分基于号段规则、IP 情报与邮箱特征综合计算，为辅助决策参考，不构成对个人身份的法律结论；最终处置请结合自身业务规则与人工复核。