API Pemeriksaan Nomor Aktif: Deteksi Aktivitas Nomor Massal

Deteksi level aktivitas nomor telepon di daftar yang Anda unggah menggunakan analitik big data yang digabungkan dengan API sistem perangkat, pembawa, dan perilaku internet. Meningkatkan tingkat keberhasilan pengiriman SMS dan mengurangi biaya operasional. Menggunakan task_type active_check dan alur polling batch yang sama dengan pengecekan lainnya.

Unggah file deteksi — contoh:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="active_check"'

Periksa status tugas — contoh:

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

Respons setelah unggahan berhasil

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 5000,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Respons saat pemrosesan

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 5000,
    "success": 2500,
    "failure": 0
}

Respons saat selesai (exported)

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 5000,
    "success": 5000,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL permintaan unggah file

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

Parameter permintaan unggah file

Parameter	Deskripsi
`file`	`file`, satu nomor telepon per baris (E.164 direkomendasikan, misalnya `+14155552671`)
`task_type`	`string`, atur ke `active_check`

URL permintaan cek status tugas

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

Parameter permintaan cek status tugas

Parameter	Deskripsi
`task_id`	`string`, ID tugas yang dikembalikan saat pembuatan tugas

Kolom hasil

Kolom	Deskripsi
`Number`	Nomor telepon dalam format E.164
`ActiveStatus`	Level aktivitas nomor: `active`, `inactive`, atau `unknown`

Format respons

Field	Deskripsi
`created_at`	Stempel waktu saat tugas dibuat
`updated_at`	Stempel waktu pembaruan status tugas terakhir
`task_id`	Pengidentifikasi tugas unik
`user_id`	ID pengguna
`status`	`pending` · `processing` · `exported` · `failed` (dikembalikan otomatis)
`total`	Total nomor yang diajukan
`success`	Nomor yang berhasil diperiksa
`failure`	Baris yang tidak dapat diproses
`result_url`	URL unduh saat `status` adalah `exported`
`actual_amount`	(Opsional) Jumlah yang benar-benar ditagih, tersedia setelah task diselesaikan
`estimated_amount`	(Respons pembuatan) Perkiraan biaya task; tagihan final diselesaikan saat task selesai

Kode status

Status	Deskripsi
`200`	`free`, Permintaan berhasil (mis. cek status)
`202`	`charge`, Task berhasil dibuat; perkiraan biaya dipotong
`400`	`free`, Permintaan tidak valid: parameter atau format file salah, jenis task tidak didukung, atau entri valid kurang dari batch minimum
`401`	`free`, API key tidak ada atau tidak valid
`402`	`free`, Saldo tidak mencukupi
`404`	`free`, Task tidak ditemukan
`413`	`free`, File yang diunggah terlalu besar
`500`	`free`, Kesalahan server internal, coba lagi nanti