概念
计算风险
学习并练习如何使用 Clearbit 的风险 API 计算风险评分。
计算风险对于提前发现注册过程中潜在问题至关重要。仅靠数据查询无法判断新注册用户是否为虚假账户。此外,在支付场景中,还需评估其是否存在较高的退款风险。因此,Clearbit 推出了风险评分计算器,用于检查以下内容:
- 某个电子邮件地址是否伪造、为临时邮箱、无法投递或看起来像虚假邮箱。
- 某个IP地址是否被列入黑名单,或使用了代理。

...
...
风险接口
API 端点
1https://risk.clearbit.com/v1/calculate
代码示例
1<script> 2 !function(){ 3 var script = document.createElement('script'); 4 script.async = true; 5 script.src = 'https://risk.clearbit.com/v1/risk.js'; 6 var parent = document.getElementsByTagName('script')[0]; 7 parent.parentNode.insertBefore(script, parent); 8 }(); 9</script>
| 字段 | 类型 | 分类 | 说明 |
|---|---|---|---|
| string | 必填 | 要计算风险评分的电子邮件地址。 | |
| ip | string | 必填 | 要计算风险评分的IP地址。 |
| country_code | string | 可选但强烈建议 | 用户所属国家的两位字母国家代码。 |
| zip_code | string | 可选但强烈建议 | 用户的邮政编码或邮编。 |
| given_name | string | 可选但强烈建议 | 用户的名。 |
| family_name | string | 可选但强烈建议 | 用户的姓。 |
| name | string | 可选 | 作为分别传入 given_name 和 family_name 的替代方式。 |
No configuration found for ID: 1ee1f659410882aee4ee67dd594320bfd70e2eab17caf214d6538eb5a6e87f65
API 响应会返回以下字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 与 Clearbit 上公司关联的内部ID。 |
| live | boolean | 标志位,表示结果是否处于实时模式(即未使用回环IP)。 |
| fingerprint | boolean | 标志位,表示结果是否命中指纹匹配。 |
| email.valid | boolean | 若为真,表示提供的邮箱在语法上有效且存在MX记录。 |
| email.socialMatch | boolean | 若为真,表示该邮箱关联有社交平台账号及存在记录。 |
| email.companyMatch | boolean | 若为真,表示该邮箱域名关联有企业信息。 |
| email.nameMatch | boolean | 若为真,表示邮箱的社交账号名称与提供姓名一致。 |
| email.disposable | boolean | 标志位,表示该邮箱是否来自临时邮箱服务(如 Mailinator)。 |
| email.freeProvider | boolean | 标志位,表示该邮箱是否来自免费邮箱服务商(如 Gmail)。 |
| email.blacklisted | boolean | 标志位,表示该邮箱是否已被列入黑名单。 |
| address.geoMatch | boolean | 标志位,表示提供的 country_code 是否与邮箱所属国家一致。 |
| ip.proxy | boolean | 标志位,表示该IP是否属于代理服务器。 |
| ip.geoMatch | boolean | 标志位,表示该IP地理位置是否与邮箱归属地一致。 |
| ip.blacklisted | boolean | 标志位,表示该IP是否已被列入黑名单。 |
| ip.rateLimited | boolean | 标志位,表示该IP是否已被限流(即被频繁使用)。 |
| risk.level | string | 与提供的邮箱和IP相关的风险等级,可能为 "low"(低)、"medium"(中)或 "high"(高)。 |
| risk.score | integer | 风险评分为0到100之间的整数。 |
| risk.reasons | array | 一个原因列表,说明 Clearbit 是如何计算出当前风险评分的。 |