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

...
...
The risk endpoint
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: bedee284d8a3740118ead249a063b977ebd5a4278deaf653d1f7c4914f35bc0c
| 字段名 | 类型 | 描述 |
|---|---|---|
| id | string | 与 Clearbit 上公司关联的内部 ID。 |
| live | boolean | 标志位,表示结果是否处于实时模式(即未使用回环 IP)。 |
| fingerprint | boolean | 标志位,表示结果是否命中指纹匹配。 |
| email.valid | boolean | 若为 true,表示提供的邮箱在语法上有效,并且存在 MX 记录。 |
| email.socialMatch | boolean | 若为 true,表示该邮箱关联有社交平台账号记录。 |
| email.companyMatch | boolean | 若为 true,表示该邮箱域名关联有企业信息。 |
| email.nameMatch | boolean | 若为 true,表示邮箱的社交账号名称与提供的姓名一致。 |
| 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 是如何得出该风险评分的。 |