Logo

计算风险

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

概念

计算风险

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

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

  • 某个电子邮件地址是否伪造、为临时邮箱、无法投递,或看起来像虚假邮箱。
  • 某个 IP 地址是否被列入黑名单,或使用了代理。
Course Image
...
...
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>
字段名类型分类描述
emailstring必填需要计算风险评分的电子邮件地址。
ipstring必填需要计算风险评分的 IP 地址。
country_codestring可选但强烈建议用户所属国家的两位字母国家代码。
zip_codestring可选但强烈建议用户的邮政编码或邮编。
given_namestring可选但强烈建议用户的名。
family_namestring可选但强烈建议用户的姓。
namestring可选替代分别传入 given_name 和 family_name 的方式。

No configuration found for ID: bedee284d8a3740118ead249a063b977ebd5a4278deaf653d1f7c4914f35bc0c

字段名类型描述
idstring与 Clearbit 上公司关联的内部 ID。
liveboolean标志位,表示结果是否处于实时模式(即未使用回环 IP)。
fingerprintboolean标志位,表示结果是否命中指纹匹配。
email.validboolean若为 true,表示提供的邮箱在语法上有效,并且存在 MX 记录。
email.socialMatchboolean若为 true,表示该邮箱关联有社交平台账号记录。
email.companyMatchboolean若为 true,表示该邮箱域名关联有企业信息。
email.nameMatchboolean若为 true,表示邮箱的社交账号名称与提供的姓名一致。
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