查询传真任务状态

查找您的任务

使用已启用的 MultiTEL API 账户。密码账户应发送 HTTP Basic 凭据，令牌账户应发送 Bearer 令牌。账户权限和 IP 限制仍然适用。不要使用后台工作进程的内部凭据。

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

job_id 为必填项，必须是 send_fax 返回的 32 字符十六进制标识符。请准确复制。请求仅限于经过身份验证的所有者。

读取结果

同时读取 HTTP 结果和 JSON 中的 status.code 字段。JSON 失败可能随 HTTP 200 一起返回。成功的 JSON 响应包含 status 和 response；示例使用虚构数据。

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

示例展示的是排队中的任务，并非已送达的传真或报价。pages_requested 是检测到的源文档页数；pages_sent 表示处理过程中记录的进度。cost 是十进制数字字符串，在排队时就可能包含估算值。result 包含处理详情；webhook_status 包含记录的回调状态。时间戳是服务器格式的字符串，不带时区偏移量。

请逐步延长轮询间隔，不要使用密集循环。处理过程可能报告已发送或已完成状态，但当前审计尚未确认向收件人送达的保证。对于重要文档，在视为已送达或重复发送之前，请向收件人确认已收到。正在运行的后台工作进程生命周期、最终计费规则和回调约定仍在核查中。不要假定进入队列或非空任务 ID 就意味着已送达。

错误

API 代码 400 表示 job_id 缺失或格式错误；401 表示缺少身份验证；404 表示未找到属于此账户的任务。不要仅凭标识符推断所有权。