Periksa status pekerjaan faks

Cari pekerjaan Anda

Gunakan akun MultiTEL API yang diaktifkan. Kirim kredensial HTTP Basic untuk akun kata sandi, atau token Bearer untuk akun token. Izin akun dan pembatasan IP tetap berlaku. Jangan gunakan kredensial internal proses pekerja.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id wajib diisi dan harus berupa pengenal heksadesimal 32 karakter yang dikembalikan oleh send_fax. Salin dengan tepat. Permintaan dibatasi pada pemilik yang terautentikasi.

Baca hasilnya

Baca hasil HTTP dan bidang status.code dalam JSON. Kegagalan JSON dapat diterima dengan HTTP 200. Respons JSON yang berhasil memiliki status dan response; contoh menggunakan data fiktif.

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

Contoh menunjukkan pekerjaan dalam antrean, bukan faks yang telah terkirim kepada penerima atau penawaran harga. pages_requested adalah jumlah halaman sumber yang terdeteksi; pages_sent melaporkan kemajuan yang dicatat selama pemrosesan. cost adalah string desimal dan mungkin sudah memuat perkiraan saat masih dalam antrean. result memuat detail pemrosesan; webhook_status memuat status callback yang tercatat. Stempel waktu adalah string berformat server tanpa offset zona waktu.

Lakukan polling dengan interval yang makin panjang, bukan dalam loop yang rapat. Pemrosesan dapat melaporkan status terkirim atau selesai, tetapi audit saat ini belum menetapkan jaminan pengiriman kepada penerima. Untuk dokumen penting, konfirmasikan penerimaannya dengan penerima sebelum menganggapnya terkirim atau mengirim duplikat. Siklus hidup proses pekerja aktif, aturan penagihan akhir, dan kontrak callback masih diverifikasi. Jangan menganggap penerimaan dalam antrean atau ID pekerjaan yang tidak kosong berarti telah terkirim kepada penerima.

Kesalahan

Kode API 400 berarti job_id tidak ada atau formatnya salah; 401 berarti autentikasi tidak ada; 404 berarti pekerjaan tidak ditemukan untuk akun ini. Jangan menyimpulkan kepemilikan hanya dari pengenal.