Pemeriksa Keterkiriman Email API

Pilih satu jenis tugas per unggahan: email_check untuk keterkiriman atau email_avatar untuk avatar. Keduanya menggunakan alur batch asinkron di bawah ini.

Pemeriksa Keterkiriman (email_check)

Memeriksa apakah alamat email aktif dan dapat menerima pesan. Hanya mendukung Gmail, Yandex, Mail.ru, iCloud, Outlook, dan Yahoo.

Pemeriksa Avatar (email_avatar)

Memeriksa apakah alamat email memiliki avatar publik dan mengembalikan URL avatar. Hanya mendukung Gmail, Yandex, dan Mail.ru.

Alamat di luar penyedia yang tercantum dan domain alias yang didukung dikecualikan dari pemrosesan, hasil, dan penagihan.

Format input

Unggah berkas teks dengan satu alamat email yang didukung per baris.

user@gmail.com
another@yandex.com

Buat tugas

POST https://api.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="email_check"'

Pemeriksa Avatar (email_avatar)

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="email_avatar"'

API mengembalikan ID tugas. Simpan ID ini dan gunakan untuk memeriksa status tugas.

Respons unggahan

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Periksa status tugas

POST https://api.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Periksa hingga status menjadi exported. Jangan menganggap pending atau processing sebagai hasil selesai.

Respons pemrosesan

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Respons yang diekspor

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Kolom hasil

Pemeriksa Keterkiriman (email_check)

Kolom	Deskripsi	Contoh
email	Alamat email dari file yang dikirim.	user@gmail.com
activated	Menunjukkan apakah input terdeteksi aktif atau terdaftar.	yes

Pemeriksa Avatar (email_avatar)

Kolom	Deskripsi	Contoh
email	Alamat email input dari file yang dikirim.	user@gmail.com
activated	Apakah alamat memiliki avatar publik.	yes
avatar	URL gambar avatar jika tersedia; kosong jika akun memakai placeholder bawaan.	https://…
name	Nama tampilan jika penyedia menampilkannya; jika tidak, kosong.	John Doe

Penanganan file hasil

Unduh file dari result_url hanya setelah tugas diekspor. Pertahankan nama kolom yang dikembalikan saat memproses file.

Kolom respons

Kolom	Deskripsi
created_at	Waktu saat tugas dibuat.
updated_at	Waktu pembaruan status tugas terakhir.
task_id	Pengenal tugas unik.
status	pending, processing, exported, atau failed.
total	Total nilai input yang diproses.
success	Nilai yang berhasil diproses.
failure	Nilai yang gagal diproses.
result_url	URL unduhan saat tugas diekspor.
actual_amount	Jumlah akhir, jika tersedia.
estimated_amount	Jumlah perkiraan yang dikembalikan saat tugas dibuat.

Kode status

Status	Deskripsi
200	Permintaan berhasil.
202	Tugas berhasil dibuat dan biaya perkiraan diterapkan.
400	File tidak valid, jenis tugas tidak didukung, atau entri valid terlalu sedikit.
401	Kunci API tidak ada atau tidak valid.
402	Saldo akun tidak mencukupi.
403	Produk tidak tersedia untuk akun Anda (dihentikan atau hanya untuk pelanggan daftar putih); hubungi dukungan.
404	Tugas tidak ditemukan.
413	File yang diunggah terlalu besar.
500	Kesalahan server internal; coba lagi nanti.
503	Produk sementara tidak tersedia (dijeda untuk pemeliharaan); tidak ada biaya yang dikenakan, coba lagi nanti.

Catatan operasional

• Tugas berjalan secara asinkron; gunakan ID tugas untuk memeriksa status.
• Periksa batas input khusus produk sebelum mengunggah.
• Baris yang gagal dilaporkan dalam hasil ekspor dan tercermin pada penghitung tugas.
• Kolom di atas berdasarkan sample live saat ini dan dapat berubah jika skema ekspor berubah.