API validasi email real-time untuk formulir pendaftaran
Validasi alamat saat pengguna mengirim formulir. Satu panggilan mengecek server email dan apakah kotak masuknya ada, lengkap dengan tanda email sekali pakai dan alamat berbasis peran, sehingga Anda yang menentukan alamat mana yang diterima. API validasi email kami memblokir data buruk sejak awal, sehingga akun palsu tidak masuk ke database Anda.
// 1. Receive submitted form data
const { email } = req.body;
// 2. Validate via API
const { data } = await checkEmail(email);
// 3. Make real-time form decision
if (data.status === 'undeliverable') {
return res.status(400).json({ error: 'Please enter a valid, active email address.' });
}
if (data.details.attributes.disposable) {
return res.status(400).json({ error: 'Temporary or disposable emails are not allowed.' });
}
// 4. Proceed with account registration
await createUser({ email });1.000 kredit gratis, tanpa kartu kredit. Kredit tidak pernah kedaluwarsa.
Kenapa regex saja bukan validasi email
Regular expression (regex) hanya mengecek susunan teks: apakah ada simbol @, apakah format domainnya masuk akal, dan apakah karakternya termasuk rentang ASCII standar. Regex hanya menjawab apakah input terlihat seperti alamat email. Regex tidak menjawab apakah ada orang yang bisa menerima pesan di alamat itu.
Alamat user@example.com atau asdf12345@gmail.com lolos dari setiap regex yang sesuai RFC. Padahal satu domain mungkin tidak punya server email yang aktif, dan kotak masuk yang lain mungkin tidak ada.
API validasi email kami dengan respons JSON jauh melampaui regular expression. Dalam satu permintaan, API ini memeriksa DNS record, mencari host MX, terhubung ke server email tujuan untuk mengetes respons kotak masuk, dan mencocokkan domain dengan daftar email sekali pakai yang besar.
Pola regex yang kaku juga menyebabkan penolakan yang salah. Regex buatan sendiri sering menolak domain tingkat atas yang jarang dipakai seperti .studio atau .cloud, karakter internasional yang valid, atau alamat sah dengan tanda baca yang tidak biasa. API kami menangani semua spesifikasi sintaks RFC 5322 secara otomatis, jadi Anda tidak perlu merawat library regex yang rapuh di kode Anda.
Cek sintaks
Menemukan salah ketik dasar, TLD yang hilang, tanda baca yang tidak diizinkan, dan spasi sebelum ada pencarian jaringan ke luar.
Verifikasi DNS dan MX
Mengecek status pendaftaran domain dan menemukan mail exchanger yang sudah diatur dan bisa menerima pesan masuk.
Cek kotak masuk
Berkomunikasi langsung dengan server email tujuan untuk memastikan apakah kotak masuk tersebut ada dan bisa menerima email.
Yang perlu diblokir, ditandai, atau diizinkan saat pendaftaran
Setiap bisnis punya kebutuhan pendaftaran yang berbeda. SaaS B2B untuk perusahaan mungkin mewajibkan email kantor, sedangkan aplikasi sosial untuk konsumen menerima alamat Gmail pribadi. Berikut tabel keputusan yang kami sarankan, berdasarkan atribut respons API yang sebenarnya:
| Hasil API | Kondisi field | Yang harus dilakukan formulir |
|---|---|---|
| Tidak valid | status === "undeliverable" | Langsung blokir. Tampilkan: "Masukkan alamat email yang valid dan aktif." |
| Email sekali pakai | details.attributes.disposable === true | Blokir, atau minta alamat lain. Tampilkan: "Alamat email sementara tidak diizinkan." |
| Alamat berbasis peran | details.attributes.role_account === true | Izinkan, tetapi tandai di formulir B2B. Beri tahu account manager atau masukkan ke kelompok kontak umum. |
| Email gratis | details.attributes.free_email === true | Izinkan di aplikasi B2C. Wajibkan email kantor di formulir demo atau uji coba B2B. |
| Catch-all | details.attributes.catch_all === true | Cek catch_all_verdict: jika "valid", izinkan. Jika "invalid", blokir. Jika null, izinkan pendaftaran. |
| Tidak diketahui | status === "unknown" | Terima dan cek ulang nanti (kredit dikembalikan). Pakai pola fail-open agar pengguna asli tidak pernah terblokir. |
Tambahkan validasi email ke formulir pendaftaran Anda
Ikuti empat langkah ini untuk memasang validasi real-time dengan aman. Karena permintaan memerlukan API key pribadi Anda, jalankan pemeriksaan dari server backend.
Kenapa pola fail-open penting: formulir pendaftaran sensitif terhadap keterlambatan. Jika panggilan API eksternal mengalami latensi jaringan, memblokir formulir bisa membuat Anda kehilangan pelanggan sungguhan. Dengan batas waktu yang singkat dan pendaftaran yang otomatis tetap berjalan, pengguna asli tidak ditolak. Sementara itu, backend Anda memasukkan alamat tersebut ke antrean untuk dicek di latar belakang nanti.
Formulir mengirim data ke backend
Saat pengunjung mengirim data pendaftaran, browser mengirim alamat email ke endpoint aplikasi Anda.
Backend memanggil API validasi
Server Anda mengirim permintaan POST sinkron ke Giggal dengan API key pribadi yang disimpan di environment variable.
Backend menerapkan tabel keputusan
Baca atribut JSON. Jika email itu email sekali pakai atau tidak dapat dikirim, kembalikan pesan error yang jelas ke browser.
Fail-open saat batas waktu habis
Jika komunikasi jaringan ke API melewati batas waktu, pakai fail-open: terima pendaftaran dan masukkan tugas latar belakang ke antrean untuk verifikasi nanti.
Contoh kode implementasi
// server.js (Express Route)
const timeoutMs = 5000; // adjust to what your form can tolerate
app.post('/api/signup', async (req, res) => {
const { email, password } = req.body;
try {
const apiRes = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email }),
signal: AbortSignal.timeout(timeoutMs), // fail-open timeout
});
const result = await apiRes.json();
if (result.success) {
const { status, details } = result.data;
// Decision checks
if (status === 'undeliverable') {
return res.status(400).json({ error: 'This email address does not exist.' });
}
if (details.attributes.disposable) {
return res.status(400).json({ error: 'Disposable email addresses are not accepted.' });
}
}
} catch (err) {
// Fail open: log timeout and let user proceed
console.warn('Email check timed out, failing open:', err.message);
}
// Create user in database
const user = await db.users.create({ email, password });
return res.json({ success: true, userId: user.id });
});# app.py (Flask Route)
import os, requests
from flask import Flask, request, jsonify
app = Flask(__name__)
timeout_seconds = 5 # adjust to what your form can tolerate
@app.route("/api/signup", methods=["POST"])
def signup():
email = request.json.get("email")
try:
resp = requests.post(
"https://api.giggal.ai/v1/verify",
headers={"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}"},
json={"email": email},
timeout=timeout_seconds # fail open on timeout
)
data = resp.json().get("data", {})
if data.get("status") == "undeliverable":
return jsonify({"error": "Email address is invalid."}), 400
if data.get("details", {}).get("attributes", {}).get("disposable"):
return jsonify({"error": "Disposable emails are prohibited."}), 400
except requests.exceptions.RequestException:
# Fail open: proceed with signup on timeout
pass
# Complete user registration
return jsonify({"success": True})// Frontend form submit handler
const form = document.querySelector('#signup-form');
form.addEventListener('submit', async (e) => {
e.preventDefault();
const email = document.querySelector('#email-input').value;
const res = await fetch('/api/signup', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ email }),
});
const payload = await res.json();
if (!res.ok) {
showFormError(payload.error); // Show friendly user feedback
} else {
redirectToDashboard();
}
});Penting: jangan pernah memanggil endpoint API Giggal langsung dari skrip sisi klien. Simpan kredensial Anda secara pribadi di server.
Hentikan pendaftaran dengan email sekali pakai dan email palsu
Kotak masuk sementara merusak data analitik produk Anda, menghabiskan kuota uji coba gratis, dan tidak pernah menjadi pelanggan berbayar. Layanan kami memantau dan menandai pola pendaftaran berisiko tinggi.
Kotak masuk sekali pakai
Dicocokkan dengan daftar aktif kami yang berisi lebih dari 100.000 domain sementara. Pelajari cara kami mengenali kotak masuk sekali pakai di pemeriksa email sekali pakai kami.
Deteksi plus addressing
Menandai alias yang dibuat dengan tanda plus (user+trial@domain.com), sehingga satu pengguna tidak bisa membuat beberapa akun uji coba.
Deteksi kotak masuk no-reply
Mendeteksi kotak masuk siaran dan otomatis yang membuang pesan masuk, sehingga pengguna tidak bisa mendaftar dengan alamat yang tidak bisa dibalas.
Jangan mengoreksi salah ketik pengguna secara otomatis
Jangan pernah mengubah input pengguna diam-diam (misalnya mengganti gnail.com menjadi gmail.com secara otomatis). Jika alamat gagal validasi, tampilkan pesan yang jelas agar pengguna mengecek isiannya. Perubahan diam-diam berisiko mengirim token aktivasi akun atau bukti tagihan ke orang yang salah.
Di mana memvalidasi email secara real-time
Validasi alamat email di setiap formulir yang diisi pengguna di produk Anda.
Formulir pendaftaran pengguna
Cegah spam pendaftaran dan pastikan email sambutan serta tautan verifikasi sampai ke kotak masuk yang aktif.
Checkout e-commerce
Pastikan pemberitahuan pengiriman, bukti pembayaran, dan konfirmasi pesanan sampai ke pelanggan tanpa gagal kirim.
Permintaan kontak dan demo
Saring isian palsu dari pesaing dan verifikasi domain perusahaan sebelum meneruskan calon pelanggan ke tim sales.
Langganan newsletter
Lindungi reputasi domain pengiriman Anda dengan menolak isian yang salah format dan pendaftaran bot saat opt-in.
Otomatisasi webhook
Jalankan validasi otomatis pada webhook formulir dengan integrasi Zapier dan n8n kami yang siap pakai.
Perubahan profil akun
Verifikasi alamat email baru saat pengguna lama mengubah profil atau kontak tagihan mereka.
Field respons yang Anda pakai saat pendaftaran
Referensi singkat tentang field JSON utama yang diperlukan untuk menjalankan logika validasi formulir.
| Field JSON | Tipe | Penggunaan saat pendaftaran |
|---|---|---|
| data.is_valid | boolean | Cek boolean cepat. Bernilai true jika pemeriksaan domain dan kotak masuk lolos. |
| data.status | string | Status pengiriman utama: "deliverable", "undeliverable", "unknown". |
| data.deliverability_score | number (0-100) | Skor kualitas berdasarkan respons kotak masuk, stabilitas MX, dan pemeriksaan reputasi. |
| data.details.attributes.disposable | boolean | Bernilai true jika domain adalah layanan kotak masuk sementara atau sekali pakai yang dikenal. |
| data.details.attributes.free_email | boolean | Bernilai true untuk penyedia konsumen (Gmail, Outlook). Wajibkan domain perusahaan di formulir B2B. |
| data.details.attributes.role_account | boolean | Bernilai true untuk alamat organisasi seperti info@, admin@, atau support@. |
| data.catch_all_verdict | "valid" | "invalid" | null | Hasil pemeriksaan untuk domain catch-all dalam panggilan yang sama. Selamatkan kontak yang valid tanpa membuangnya. |
Untuk definisi endpoint, skema parameter, dan kode error yang lengkap, lihat referensi API lengkap.
Harga API validasi email
Bayar hanya untuk validasi yang Anda jalankan, tanpa minimum atau komitmen bulanan. Setiap panggilan validasi API memakai 1 kredit, termasuk pemeriksaan catch-all dalam panggilan yang sama. Kredit untuk hasil tidak diketahui dikembalikan secara otomatis, dan 1.000 kredit pertama Anda gratis.
Lihat semua paket volume dan diskon langganan bulanan di halaman harga kami.
FAQ API validasi email
Jawaban untuk pertanyaan umum tentang pemasangan di formulir pendaftaran dan validasi real-time.
Ada. Setiap akun baru mendapat 1.000 kredit gratis saat mendaftar, tanpa kartu kredit. Anda bisa membuat API key di dashboard developer dan langsung mulai mengetes validasi formulir secara real-time. Kredit gratis tidak pernah kedaluwarsa dan memberi akses penuh ke semua atribut dan pemeriksaan validasi.
Tidak. Memanggil API langsung dari JavaScript sisi klien akan memperlihatkan API key rahasia Anda kepada siapa pun yang memeriksa permintaan jaringan di browser. Selalu kirim isian formulir pengguna ke server backend atau serverless function Anda sendiri dulu, lalu biarkan server Anda mengirim permintaan ke https://api.giggal.ai/v1/verify.
Tidak ada pesan yang pernah dikirim. API mengecek apakah kotak masuknya ada. API menutup koneksi sebelum data atau isi email apa pun dikirim, jadi tidak ada email yang masuk ke kotak masuk pengguna Anda.
Ya. Setiap pemeriksaan mencocokkan domain dengan daftar kami yang berisi lebih dari 100.000 domain email sekali pakai dan sementara. Jika cocok, details.attributes.disposable bernilai true dan status diatur ke undeliverable, sehingga backend Anda bisa memblokir akun sementara.
Tergantung model bisnis Anda. Untuk aplikasi konsumen, alamat berbasis peran seperti support@ atau info@ bisa saja milik organisasi yang sah. Untuk SaaS B2B self-serve yang membutuhkan tanggung jawab per pengguna, banyak perusahaan memilih menandai atau menolak alamat berbasis peran umum untuk mencegah penyalahgunaan akun bersama.
Domain catch-all menerima semua alamat penerima tanpa syarat, sehingga pemeriksaan biasa tidak memberi kepastian. API kami menjalankan pemeriksaan catch-all mendalam dalam panggilan yang sama untuk menilai apakah kotak masuknya ada. Jika pemeriksaan catch-all memberi hasil "valid", Anda bisa mengizinkan pendaftaran dengan aman. Jika hasilnya "invalid", alamat itu akan bounce dan sebaiknya ditolak.
Kami menyarankan pola fail-open. Jika panggilan dari backend Anda mengalami batas waktu jaringan atau error koneksi, biarkan pendaftaran selesai daripada memblokir calon pelanggan. Masukkan alamat yang belum divalidasi ke antrean worker latar belakang untuk mengecek ulang status pengirimannya nanti.
Pilih API validasi email jika Anda butuh pemeriksaan real-time di formulir pendaftaran web untuk menghentikan salah ketik, kotak masuk sekali pakai, dan bot saat formulir dikirim. Pilih API verifikasi email jika Anda mengaudit database marketing yang sudah ada, menyinkronkan kontak CRM, atau membersihkan file email massal sebelum mengirim kampanye.
Lindungi formulir pendaftaran Anda hari ini
1.000 kredit gratis, tanpa kartu kredit.
