Lihat daftar tugas faks keluar

Lihat daftar tugas faks keluar

Gunakan akun API MultiTEL yang telah diaktifkan melalui HTTPS dengan kredensial dan pembatasan IP yang dikonfigurasikan untuk akun tersebut. Endpoint ini menampilkan daftar catatan faks keluar milik akun yang terautentikasi. Menampilkan daftar tidak mengirim atau mengirim ulang faks.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Penangan ini tidak mendukung filter date_from atau date_to. Kotak keluar di portal memiliki filter tambahan yang tidak boleh disalin ke permintaan API ini. Hasil diurutkan berdasarkan waktu pembuatan, dari yang terbaru, tanpa pengurutan sekunder berdasarkan ID atau kursor snapshot.

Baca catatan tugas

Baca hasil HTTP dan status.code dalam JSON. Respons yang berhasil berisi response.faxes dan response.pagination; contoh menggunakan data fiktif. Kotak surat yang kosong mengembalikan larik faxes kosong dengan total 0 dan total_pages 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id adalah ID numerik catatan. uuid adalah pengenal tugas yang ditampilkan; gunakan ID tugas yang dikembalikan oleh send_fax untuk pengajuan baru dan simpan ID tersebut untuk pemeriksaan status berkala. Daftar dapat mencakup catatan lama, jadi jangan menganggap setiap baris dibuat melalui endpoint pengajuan yang sama.

status dan result_text memuat status pemrosesan dan pesan yang tercatat. Daftar ini tidak menormalkan keduanya menjadi enumerasi lengkap status pengiriman. Status dalam antrean berarti masih mengantre, bukan sudah terkirim. Untuk dokumen penting, konfirmasikan penerimaan kepada penerima sebelum menganggap faks telah sampai atau mengajukan salinannya untuk dikirim lagi.

pages_requested dan pages_sent adalah jumlah dalam bentuk angka. cost mempertahankan nilai yang tersimpan, dengan string 0.00 sebagai nilai cadangan; jangan menganggap tipe JSON-nya sama dengan tipe biaya di kotak masuk. Catatan yang masih mengantre bisa saja sudah memuat perkiraan biaya. Baik nilai tersebut maupun entri dalam daftar tidak menetapkan tagihan akhir.

created_at, sent_at dan updated_at adalah nilai tersimpan dalam format server tanpa offset zona waktu; sent_at dapat bernilai null. Daftar ini tidak menyertakan kolom status webhook yang dikembalikan oleh endpoint status terpisah.

Cocokkan catatan antarhalaman dengan aman

Ikuti pagination.page, limit, total, dan total_pages. Halaman setelah halaman terakhir dapat kosong. Tugas baru dapat menggeser entri antarhalaman saat Anda menelusuri daftar. Pertahankan pengenal tugas saat menggabungkan catatan dari beberapa halaman; endpoint ini tidak menjamin snapshot yang tetap.

Privasi dan percobaan ulang

Catatan kotak keluar berisi metadata telepon yang bersifat pribadi. Batasi siapa yang dapat membacanya dan hindari mencatat respons lengkap ke log. Tidak adanya entri dalam daftar bukan bukti bahwa permintaan pengiriman gagal: periksa ID tugas yang disimpan dan kotak keluar di portal sebelum mengajukan ulang. Pengiriman baru dapat membuat faks tambahan yang berpotensi dikenai biaya. Jaminan akhir terkait proses pekerja, penagihan, panggilan balik, dan retensi masih dalam peninjauan.