文档

把采集脚本加到注册页面，从服务器调用一个接口，再根据决定处理。

快速开始

1. 在注册页面加入采集脚本

它会采集设备信号，并在页面每个表单中放入名为 attrelix_visitor 的隐藏字段，内含短期有效的访客令牌。单页应用可使用 window.attrelix.token()。

<script src="https://attrelix.com/v1.js?v=0bbe74b52d" data-key="pk_live_…" async></script>

// single-page apps: wait for the token before you submit
const visitor = await window.attrelix.token();

2. 从服务器检测这次注册

用私密密钥发送邮箱、客户端 IP 和访客令牌。可选：external_id（你的用户 id）、user_agent 和 card_fingerprint（例如 Stripe 的 card.fingerprint）。

curl https://attrelix.com/v1/check \
  -H "Authorization: Bearer $ATTRELIX_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"email":"jdoe+7@gmail.com","ip":"203.0.113.9","visitor":"vt1.…"}'

# Python
r = requests.post("https://attrelix.com/v1/check", timeout=3,
    headers={"Authorization": f"Bearer {SECRET}"},
    json={"email": email, "ip": ip, "visitor": form["attrelix_visitor"]})
decision = r.json().get("decision", "allow") if r.ok else "allow"

3. 根据决定处理

allow：发放免费额度。review：要求让团伙付出成本的东西——银行卡、手机号——或少发额度。block：拒绝账号或额度。如果调用失败，请放行：绝不要因为我们而拦住真实用户。

密钥与令牌

• 公开密钥（pk_live_…）：本来就是公开的。它放在你的页面里，只能在控制台允许的来源上采集信号。
• 私密密钥（sk_live_…）：仅限服务器使用。用于发起检测和读取结果。我们只保存它的哈希：请在创建时复制。
• 访客令牌：由我们签名，有效期 15 分钟，仅可用于一次检测，并绑定你的项目。重复使用的令牌，或来自与注册请求不同网络的令牌，会提高评分。

POST /v1/check

请求体（JSON）。email、ip、visitor 至少提供一个。

响应

decision 为 allow、review 或 block。score 介于 0 到 100：各原因分值之和，有上限。每个原因都有稳定的代码，可记录或展示。

{
  "id": "chk_3fJ8kQ2mN7pX1aZb",
  "decision": "block",
  "score": 100,
  "reasons": [
    { "code": "linked_accounts_10", "points": 45, "detail": "14" },
    { "code": "alias_of_existing", "points": 30, "detail": "3 variants of jdoe@gmail.com" },
    { "code": "datacenter_ip", "points": 25, "detail": "aws" }
  ],
  "email":   { "normalized": "jdoe@gmail.com", "disposable": false, "relay": false, "mx": "yes", … },
  "network": { "ip": "3.88.0.1", "type": "datacenter", "provider": "aws", "signups_24h": 2 },
  "device":  { "id": "dev_9c1e…", "token": "valid", "browser": "Firefox 144", "flags": ["canvas_noise"] },
  "linked":  { "accounts": 14, "by_device": 12, "by_card": 0, "cluster": "cl_7q2f…" },
  "latency_ms": 38
}

错误

错误以 JSON 返回：{"error": code, "message": text}。

评分

分值相加，上限 100。默认 50 分起复核、80 分起拦截，两者都可调整。仅凭一次性邮箱即进入复核；任何单一设备或网络信号都不会。

数据来源

一次性邮箱域名：disposable-email-domains 项目（CC0）和 disposable/disposable-email-domains（MIT），每日更新。数据中心网段：AWS、Google Cloud、Oracle Cloud、DigitalOcean 和 Linode 公布的列表。Tor：Tor Project 的出口节点列表，每小时更新。

当前：98,644 个一次性邮箱域名，21,665 个网段。