Consultar los trabajos de fax salientes

Consultar los trabajos de fax salientes

Utilice una cuenta habilitada de la API de MultiTEL mediante HTTPS, con sus credenciales y restricciones de IP configuradas. Este punto de acceso enumera los registros de fax salientes que pertenecen a la cuenta autenticada. Consultar la lista no transmite ni reenvía ningún fax.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Este controlador no admite los filtros date_from ni date_to. La bandeja de salida del portal tiene filtros adicionales que no deben copiarse en esta solicitud a la API. Los resultados se ordenan por fecha y hora de creación, del más reciente al más antiguo, sin un orden secundario por identificador ni un cursor de instantánea.

Consultar los registros de los trabajos

Compruebe tanto el resultado HTTP como, en el documento JSON, el campo status.code. Una respuesta correcta contiene response.faxes y response.pagination; el ejemplo utiliza datos ficticios. Una bandeja vacía devuelve una matriz faxes vacía con total igual a 0 y total_pages igual a 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id es el identificador numérico del registro. uuid es el identificador visible del trabajo; utilice el identificador del trabajo devuelto por send_fax para los nuevos envíos y consérvelo para realizar consultas periódicas del estado. La lista puede incluir registros antiguos, por lo que no debe suponer que todas las filas se crearon mediante el mismo punto de acceso de envío.

status y result_text contienen el estado y el mensaje de procesamiento registrados. Esta lista no los normaliza en una enumeración completa de estados de entrega. En cola significa en cola, no entregado. En el caso de documentos críticos, confirme la recepción con el destinatario antes de considerar el fax entregado o enviar un duplicado.

pages_requested y pages_sent son recuentos numéricos. cost conserva el valor almacenado y utiliza como alternativa la cadena de texto 0.00; no suponga que tiene el mismo tipo JSON que el coste de la bandeja de entrada. Un registro en cola ya puede contener una estimación. Ni ese valor ni una entrada de la lista determinan la facturación definitiva.

created_at, sent_at y updated_at son valores almacenados con el formato del servidor y sin desplazamiento de zona horaria; sent_at puede ser nulo. La lista omite el campo de estado del webhook que devuelve el punto de acceso independiente de consulta del estado.

Conciliar las páginas de resultados de forma segura

Guíese por pagination.page, limit, total y total_pages. Las páginas posteriores a la última pueden estar vacías. Los nuevos trabajos pueden desplazar entradas entre páginas mientras las consulta. Conserve los identificadores de los trabajos al combinar páginas; este punto de acceso no garantiza una instantánea estable.

Privacidad y reintentos

Los registros de la bandeja de salida contienen metadatos telefónicos privados. Limite quién puede consultarlos y evite guardar respuestas completas en los registros de actividad. Que una entrada no aparezca en la lista no demuestra que una solicitud de envío haya fallado: compruebe el identificador del trabajo conservado y la bandeja de salida del portal antes de volver a enviarla. Un nuevo envío puede crear otro fax que podría generar cargos. Las garantías definitivas sobre el procesamiento en segundo plano, la facturación, las notificaciones de retorno y la conservación de datos siguen en revisión.