Email Avatar Checker API: Pencarian avatar multi-domain

Unggah daftar alamat email campuran dan biarkan dirutekan otomatis berdasarkan domain. Mengembalikan apakah setiap alamat memiliki avatar publik, URL avatar, serta nama tampilan jika penyedia menampilkannya. Mendukung Gmail, Yandex, dan Mail.ru beserta domain aliasnya; alamat dari domain lain tidak dikirim dan tidak dikembalikan. Tugas ini menggunakan alur kerja batch asinkron standar.

Format input

Unggah file teks dengan satu alamat email per baris. Normalisasi nilai sebelum mengunggah.

user@example.com
another@example.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_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

Kolom	Deskripsi	Contoh
email	Alamat email input dari file yang dikirim.	user@example.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.