开发者

GET/v3/fax_download?job_id={job_id}

下载外发传真文档

获取您某个外发传真任务的可用文档。

本页
  1. 请求文档
  2. 处理文件或 JSON 错误
  3. 可用性与隐私

请求文档

使用已启用的 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。

可用性与隐私

存在任务记录并不保证文件永远可供下载;保留期限尚未核实。需要时,请将您有权获取的文档保存到由您自行控制的存储空间。返回的文件可能包含收件人的私人信息。下载不会发送新的传真。