Liệt kê các tác vụ fax gửi đi

Liệt kê các tác vụ fax gửi đi

Sử dụng tài khoản API MultiTEL đã được kích hoạt qua HTTPS, với thông tin xác thực và các giới hạn địa chỉ IP đã cấu hình cho tài khoản đó. Điểm cuối này liệt kê các bản ghi fax gửi đi thuộc tài khoản đã xác thực. Việc liệt kê không truyền hoặc gửi lại fax.

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

Bộ xử lý này không hỗ trợ bộ lọc date_from hoặc date_to. Hộp fax đi trên cổng thông tin có thêm các bộ lọc; không nên sao chép chúng vào yêu cầu API này. Kết quả được sắp xếp theo thời gian tạo, mới nhất trước, không có tiêu chí sắp xếp phụ theo mã định danh hoặc con trỏ ảnh chụp dữ liệu tại một thời điểm.

Đọc các bản ghi tác vụ

Đọc cả kết quả HTTP và status.code trong JSON. Phản hồi thành công chứa response.faxes và response.pagination; ví dụ sử dụng dữ liệu giả định. Hộp fax trống trả về mảng faxes rỗng với total bằng 0 và total_pages bằng 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 là mã định danh dạng số của bản ghi. uuid là mã định danh tác vụ được hiển thị; hãy sử dụng mã tác vụ do send_fax trả về cho các lần gửi mới và lưu mã đó để thăm dò trạng thái định kỳ. Danh sách có thể bao gồm các bản ghi cũ hơn, vì vậy đừng cho rằng mọi dòng đều được tạo qua cùng một điểm cuối gửi fax.

status và result_text chứa trạng thái xử lý và thông báo đã ghi nhận. Danh sách này không chuẩn hóa chúng thành một tập giá trị liệt kê đầy đủ về trạng thái chuyển fax. Đang xếp hàng có nghĩa là đang chờ trong hàng đợi, không phải đã chuyển đến người nhận. Với tài liệu quan trọng, hãy xác nhận việc nhận tài liệu với người nhận trước khi coi fax là đã được chuyển đến hoặc gửi thêm một bản trùng lặp.

pages_requested và pages_sent là các số đếm. cost giữ nguyên giá trị đã lưu, với giá trị dự phòng là chuỗi 0.00; đừng cho rằng giá trị này có cùng kiểu dữ liệu JSON với chi phí trong hộp fax đến. Bản ghi đang xếp hàng có thể đã chứa một khoản ước tính. Cả giá trị đó lẫn một mục trong danh sách đều không xác lập khoản cước cuối cùng.

created_at, sent_at và updated_at là các giá trị được lưu theo định dạng của máy chủ, không kèm độ lệch múi giờ; sent_at có thể là null. Danh sách không bao gồm trường trạng thái webhook mà điểm cuối trạng thái riêng biệt trả về.

Đối chiếu các trang kết quả một cách an toàn

Theo dõi pagination.page, limit, total và total_pages. Các trang sau trang cuối có thể trống. Tác vụ mới có thể khiến các mục chuyển từ trang này sang trang khác trong khi bạn duyệt. Hãy giữ lại mã định danh tác vụ khi gộp các trang; điểm cuối này không bảo đảm dữ liệu là một ảnh chụp ổn định tại cùng một thời điểm.

Quyền riêng tư và thử lại

Các bản ghi trong hộp fax đi chứa siêu dữ liệu điện thoại riêng tư. Hãy giới hạn những người có quyền đọc và tránh ghi toàn bộ phản hồi vào nhật ký. Việc thiếu một mục trong danh sách không chứng minh rằng yêu cầu gửi đã thất bại: hãy kiểm tra mã tác vụ đã lưu và hộp fax đi trên cổng thông tin trước khi gửi lại yêu cầu. Một lần gửi mới có thể tạo thêm một bản fax có khả năng bị tính cước. Các bảo đảm cuối cùng về tiến trình xử lý nền, tính cước, gọi lại và lưu giữ dữ liệu vẫn đang được xem xét.