Kiểm tra trạng thái tác vụ fax

Tra cứu tác vụ của bạn

Sử dụng tài khoản MultiTEL API đã bật. Gửi thông tin đăng nhập HTTP Basic cho tài khoản mật khẩu hoặc mã thông báo Bearer cho tài khoản mã thông báo. Quyền của tài khoản và hạn chế IP vẫn áp dụng. Không sử dụng thông tin đăng nhập nội bộ của tiến trình xử lý.

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

job_id là bắt buộc và phải là mã định danh thập lục phân gồm 32 ký tự do send_fax trả về. Sao chép chính xác mã này. Yêu cầu được giới hạn theo chủ sở hữu đã xác thực.

Đọc kết quả

Đọc cả kết quả HTTP lẫn trường status.code trong JSON. Lỗi JSON có thể được trả về cùng HTTP 200. Phản hồi JSON thành công có status và response; các ví dụ dùng dữ liệu giả định.

{
  "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"
  }
}

Ví dụ là một tác vụ trong hàng đợi, không phải fax đã được giao hay báo giá. pages_requested là số trang nguồn được phát hiện; pages_sent cho biết tiến độ được ghi lại trong quá trình xử lý. cost là chuỗi số thập phân và có thể đã chứa giá trị ước tính khi còn trong hàng đợi. result chứa chi tiết xử lý; webhook_status chứa trạng thái gọi lại đã ghi nhận. Dấu thời gian là các chuỗi theo định dạng máy chủ, không có độ lệch múi giờ.

Thăm dò với khoảng thời gian tăng dần thay vì vòng lặp liên tục dồn dập. Quá trình xử lý có thể báo trạng thái đã gửi hoặc đã hoàn tất, nhưng đợt kiểm tra hiện tại chưa xác lập bảo đảm giao đế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 là đã giao hoặc gửi bản trùng lặp. Vòng đời của tiến trình xử lý đang hoạt động, quy tắc tính phí cuối cùng và hợp đồng gọi lại vẫn đang được kiểm chứng. Đừng cho rằng được chấp nhận vào hàng đợi hoặc ID tác vụ không rỗng có nghĩa là đã giao.

Lỗi

Mã API 400 nghĩa là thiếu hoặc sai định dạng job_id; 401 nghĩa là thiếu xác thực; 404 nghĩa là không tìm thấy tác vụ cho tài khoản này. Không suy ra quyền sở hữu chỉ từ mã định danh.