Logo

计算风险

学习并练习如何使用 Clearbit 的风险 API 计算风险评分。

概念

计算风险

学习并练习如何使用 Clearbit 的风险 API 计算风险评分。

计算风险对于提前发现注册过程中潜在问题至关重要。仅靠数据查询无法判断新注册用户是否为虚假账户。此外,在支付场景中,还需评估其是否存在较高的退款风险。因此,Clearbit 推出了风险评分计算器,用于检查以下内容:

  • 某个电子邮件地址是否伪造、为临时邮箱、无法投递或看起来像虚假邮箱。
  • 某个IP地址是否被列入黑名单,或使用了代理。
Course Image
...
...
风险接口

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>
字段类型分类说明
emailstring必填要计算风险评分的电子邮件地址。
ipstring必填要计算风险评分的IP地址。
country_codestring可选但强烈建议用户所属国家的两位字母国家代码。
zip_codestring可选但强烈建议用户的邮政编码或邮编。
given_namestring可选但强烈建议用户的名。
family_namestring可选但强烈建议用户的姓。
namestring可选作为分别传入 given_name 和 family_name 的替代方式。

No configuration found for ID: 1ee1f659410882aee4ee67dd594320bfd70e2eab17caf214d6538eb5a6e87f65

API 响应会返回以下字段:

字段类型说明
idstring与 Clearbit 上公司关联的内部ID。
liveboolean标志位,表示结果是否处于实时模式(即未使用回环IP)。
fingerprintboolean标志位,表示结果是否命中指纹匹配。
email.validboolean若为真,表示提供的邮箱在语法上有效且存在MX记录。
email.socialMatchboolean若为真,表示该邮箱关联有社交平台账号及存在记录。
email.companyMatchboolean若为真,表示该邮箱域名关联有企业信息。
email.nameMatchboolean若为真,表示邮箱的社交账号名称与提供姓名一致。
email.disposableboolean标志位,表示该邮箱是否来自临时邮箱服务(如 Mailinator)。
email.freeProviderboolean标志位,表示该邮箱是否来自免费邮箱服务商(如 Gmail)。
email.blacklistedboolean标志位,表示该邮箱是否已被列入黑名单。
address.geoMatchboolean标志位,表示提供的 country_code 是否与邮箱所属国家一致。
ip.proxyboolean标志位,表示该IP是否属于代理服务器。
ip.geoMatchboolean标志位,表示该IP地理位置是否与邮箱归属地一致。
ip.blacklistedboolean标志位,表示该IP是否已被列入黑名单。
ip.rateLimitedboolean标志位,表示该IP是否已被限流(即被频繁使用)。
risk.levelstring与提供的邮箱和IP相关的风险等级,可能为 "low"(低)、"medium"(中)或 "high"(高)。
risk.scoreinteger风险评分为0到100之间的整数。
risk.reasonsarray一个原因列表,说明 Clearbit 是如何计算出当前风险评分的。

增强API

域名和Logo APIs