请求文档
使用已启用的 MultiTEL API 账户。对于密码账户,发送 HTTP Basic 凭据;对于令牌账户,发送 Bearer 令牌。账户权限和 IP 限制仍然适用。请勿使用内部工作进程的凭据。
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_download使用必填的 32 位十六进制 job_id,与 fax_status 使用的值相同。客户请求仅限于已通过身份验证的任务所有者。此示例将响应头和响应字节分别保存,以免将 API 错误误认为 PDF 文件。
处理文件或 JSON 错误
成功时返回文档的原始字节,并附带 Content-Type 和 Content-Disposition 附件响应头,而非 JSON 封装结构。在为保存的文件命名、打开或处理该文件之前,请检查这些响应头。根据可用的文档,响应可能采用 PDF、TIFF 或最初上传的格式。排队中的任务可能会在转换前返回其原始源文件。
失败时返回常规的 JSON status/response 封装结构。API 代码 400 表示缺少 job_id 或其格式不正确;401 表示缺少身份验证;404 表示该账户无法获取此任务或其文件。即使 HTTP 状态为 200,也要检查 Content-Type 和 status.code。
可用性与隐私
存在任务记录并不保证文件永远可供下载;保留期限尚未核实。需要时,请将您有权获取的文档保存到由您自行控制的存储空间。返回的文件可能包含收件人的私人信息。下载不会发送新的传真。