Yêu cầu tài liệu
Sử dụng tài khoản API MultiTEL đã được kích hoạt. Gửi thông tin xác thực HTTP Basic đối với tài khoản dùng mật khẩu, hoặc mã thông báo Bearer đối với tài khoản dùng mã thông báo. Các quyền của tài khoản và hạn chế về địa chỉ IP vẫn được áp dụng. Không sử dụng thông tin xác thực của tiến trình xử lý nội bộ.
curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
--data-urlencode job_id=0123456789abcdef0123456789abcdef \
--dump-header fax-response.headers --output fax-response.bin \
https://api.multitel.net/v3/fax_downloadSử dụng job_id bắt buộc ở dạng thập lục phân gồm 32 ký tự, giống như khi dùng fax_status. Chỉ chủ sở hữu đã được xác thực mới được thực hiện yêu cầu này của khách hàng. Ví dụ này lưu riêng các tiêu đề phản hồi và dữ liệu byte để tránh nhầm lỗi API với tệp PDF.
Xử lý tệp hoặc lỗi dạng JSON
Khi thành công, phản hồi trả về dữ liệu byte thô của tài liệu cùng các tiêu đề Content-Type và Content-Disposition cho tệp đính kèm, chứ không phải cấu trúc bao ngoài dạng JSON. Hãy kiểm tra các tiêu đề đó trước khi đặt tên, mở hoặc xử lý tệp đã lưu. Phản hồi có thể là tệp PDF, TIFF hoặc ở định dạng gốc đã tải lên, tùy theo tài liệu hiện có. Một tác vụ đang trong hàng đợi có thể trả về tệp nguồn gốc của nó trước khi chuyển đổi.
Khi thất bại, phản hồi trả về cấu trúc bao ngoài JSON status/response thông thường. Mã API 400 có nghĩa là thiếu job_id hoặc giá trị này sai định dạng; 401 có nghĩa là thiếu thông tin xác thực; 404 có nghĩa là tác vụ hoặc tệp của tác vụ không khả dụng cho tài khoản này. Hãy kiểm tra Content-Type và status.code ngay cả khi trạng thái HTTP là 200.
Khả năng truy xuất và quyền riêng tư
Việc có bản ghi tác vụ không bảo đảm rằng tệp sẽ luôn có sẵn để tải xuống; thời hạn lưu giữ chưa được xác minh. Khi cần, hãy lưu các tài liệu mà bạn có quyền truy cập vào nơi lưu trữ do chính bạn kiểm soát. Tệp được trả về có thể chứa thông tin riêng tư của người nhận. Việc tải xuống không gửi đi một bản fax mới.