Dokumentasi

Pasang agen di halaman pendaftaran, panggil satu endpoint dari server Anda, lalu bertindak sesuai keputusan.

Mulai cepat

1. Pasang agen di halaman pendaftaran

Agen mengumpulkan sinyal perangkat dan memasukkan token pengunjung berumur pendek ke kolom tersembunyi bernama attrelix_visitor di setiap formulir pada halaman. Untuk aplikasi satu halaman tersedia 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. Periksa pendaftaran dari server Anda

Kirim email, IP klien, dan token pengunjung dengan kunci rahasia Anda. Opsional: external_id (id pengguna Anda), user_agent, dan card_fingerprint (misalnya card.fingerprint dari 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. Bertindak sesuai keputusan

allow: berikan kredit gratis. review: minta sesuatu yang membuat peternakan keluar uang — kartu, nomor telepon — atau berikan kredit lebih sedikit. block: tolak akun atau kreditnya. Jika panggilan gagal, izinkan: jangan pernah mengunci pengguna asli karena kami.

Kunci dan token

• Kunci publik (pk_live_…): memang publik. Ada di halaman Anda dan hanya bisa mengumpulkan sinyal, dari origin yang Anda izinkan di dasbor.
• Kunci rahasia (sk_live_…): hanya di server. Menjalankan pemeriksaan dan membaca hasil. Kami hanya menyimpan hash-nya: salin saat Anda membuatnya.
• Token pengunjung: ditandatangani oleh kami, berlaku 15 menit dan untuk satu pemeriksaan, terikat pada proyek Anda. Token yang dipakai dua kali, atau dari jaringan berbeda dengan pendaftaran, menaikkan skor.

POST /v1/check

Body permintaan (JSON). Kirim minimal salah satu dari email, ip, atau visitor.

Respons

decision bernilai allow, review, atau block. score 0–100: jumlah poin alasan, dengan batas atas. Setiap alasan punya kode tetap yang bisa Anda catat atau tampilkan.

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

Error

Error berupa JSON: {"error": code, "message": text}.

Penilaian

Poin dijumlahkan dengan batas 100. Bawaan: tinjau mulai 50, blokir mulai 80 — keduanya bisa diatur. Kotak surat sekali pakai saja sudah masuk tinjau; tidak ada satu sinyal perangkat atau jaringan yang sendirian sampai ke sana.

Sumber data

Domain sekali pakai: proyek disposable-email-domains (CC0) dan disposable/disposable-email-domains (MIT), diperbarui setiap hari. Rentang pusat data: daftar yang dipublikasikan AWS, Google Cloud, Oracle Cloud, DigitalOcean, dan Linode. Tor: daftar node keluar dari Tor Project, diperbarui setiap jam.

Saat ini: 98,644 domain sekali pakai dan 21,665 rentang.