Documentación

Añade el agente a tu página de registro, llama a un endpoint desde tu servidor y actúa según la decisión.

Inicio rápido

1. Añade el agente a tu página de registro

Recoge señales del dispositivo y pone un token de visitante de corta vida en un campo oculto llamado attrelix_visitor en cada formulario de la página. También expone window.attrelix.token() para single-page apps.

<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. Verifica el registro desde tu servidor

Envía el correo, la IP del cliente y el token de visitante con tu clave secreta. Opcional: external_id (el id de tu usuario), user_agent y card_fingerprint (por ejemplo el card.fingerprint de Stripe).

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. Actúa según la decisión

allow: da los créditos gratis. review: pide algo que le cueste dinero a una granja — una tarjeta, un teléfono — o da menos créditos. block: rechaza la cuenta o los créditos. Si la llamada falla, permite: nunca bloquees a usuarios reales por nuestra culpa.

Claves y tokens

• Clave pública (pk_live_…): pública por diseño. Va en tu página y solo recoge señales, desde los orígenes que permitas en el panel.
• Clave secreta (sk_live_…): solo en el servidor. Ejecuta verificaciones y lee resultados. Solo guardamos su hash: cópiala al crearla.
• Token de visitante: firmado por nosotros, válido 15 minutos y para una sola verificación, ligado a tu proyecto. Un token usado dos veces, o desde otra red distinta a la del registro, sube la puntuación.

POST /v1/check

Cuerpo de la petición (JSON). Envía al menos uno de email, ip o visitor.

Respuesta

decision es allow, review o block. score va de 0 a 100: la suma de los puntos de los motivos, con tope. Cada motivo tiene un código estable que puedes registrar o mostrar.

{
  "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
}

Errores

Los errores son JSON: {"error": code, "message": text}.

Puntuación

Los puntos se suman con un tope de 100. Por defecto: revisar desde 50, bloquear desde 80 — ambos ajustables. Un buzón desechable solo ya va a revisión; ninguna señal aislada de dispositivo o red llega ahí.

Fuentes de datos

Dominios desechables: el proyecto disposable-email-domains (CC0) y disposable/disposable-email-domains (MIT), actualizados a diario. Rangos de datacenter: las listas publicadas por AWS, Google Cloud, Oracle Cloud, DigitalOcean y Linode. Tor: la lista de salidas del Tor Project, actualizada cada hora.

Ahora mismo: 98,644 dominios desechables y 21,665 rangos.