Consultar o estado de um trabalho de fax

Consulte o seu trabalho

Use uma conta MultiTEL API habilitada. Envie credenciais HTTP Basic para uma conta com senha, ou um token Bearer para uma conta com token. As permissões da conta e as restrições de IP ainda se aplicam. Não use credenciais internas de worker.

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

job_id é obrigatório e deve ser o identificador hexadecimal de 32 caracteres devolvido por send_fax. Copie-o exatamente. As solicitações ficam delimitadas ao proprietário autenticado.

Leia o resultado

Leia tanto o resultado HTTP como o JSON status.code. Falhas JSON podem chegar com HTTP 200. Uma resposta JSON bem-sucedida tem status e response; os exemplos usam dados fictícios.

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

O exemplo é um trabalho em fila, não um fax entregue nem uma cotação de preço. pages_requested é a contagem de páginas de origem detectada; pages_sent relata o progresso registrado pelo processamento. cost é uma string decimal e já pode conter uma estimativa enquanto estiver em fila. result contém o detalhe do processamento; webhook_status contém o estado de callback registrado. Os timestamps são strings formatadas pelo servidor, sem um deslocamento de fuso horário.

Consulte com intervalos crescentes em vez de um loop apertado. O processamento pode reportar um estado enviado ou concluído, mas a auditoria atual não estabeleceu uma garantia de entrega ao destinatário. Para um documento crítico, confirme o recebimento com o destinatário antes de tratá-lo como entregue ou de enviar um duplicado. O ciclo de vida do worker ativo, as regras finais de faturamento e o contrato de callback ainda estão sendo verificados. Não assuma que a aceitação na fila ou um ID de trabalho não vazio significa entrega.

Erros

API código 400 significa job_id ausente ou malformado; 401 significa autenticação ausente; 404 significa que o trabalho não foi encontrado para esta conta. Não infira a titularidade apenas a partir do identificador.