Elencare le operazioni fax in uscita

Elencare le operazioni fax in uscita

Usa un account API MultiTEL abilitato tramite HTTPS, con le credenziali e le restrizioni IP configurate per l'account. Questo endpoint elenca i record dei fax in uscita appartenenti all'account autenticato. La consultazione dell'elenco non trasmette né reinvia alcun 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

Questo gestore non supporta i filtri date_from o date_to. La sezione dei fax in uscita del portale dispone di filtri aggiuntivi che non devono essere copiati in questa richiesta API. I risultati sono ordinati per data e ora di creazione, dal più recente, senza un ordinamento secondario per identificativo né un cursore relativo a un'istantanea dei dati.

Consultare i record delle operazioni

Controlla sia il risultato HTTP sia il campo status.code nel JSON. Una risposta riuscita contiene response.faxes e response.pagination; l'esempio usa dati fittizi. Una casella vuota restituisce un array faxes vuoto con total pari a 0 e total_pages pari 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 è l'identificativo numerico del record. uuid è l'identificativo visibile dell'operazione; per i nuovi invii usa l'identificativo dell'operazione restituito da send_fax e conservalo per il controllo periodico dello stato. L'elenco può includere record più vecchi, quindi non dare per scontato che ogni riga sia stata creata tramite lo stesso endpoint di invio.

status e result_text riportano lo stato di elaborazione e il messaggio registrati. Questo elenco non li normalizza in un insieme enumerato completo degli stati di consegna. In coda significa in coda, non consegnato. Per i documenti critici, conferma la ricezione con il destinatario prima di considerare il fax consegnato o inviarne un duplicato.

pages_requested e pages_sent sono conteggi numerici. cost mantiene il valore memorizzato, con la stringa 0.00 come valore di ripiego; non dare per scontato che abbia lo stesso tipo JSON del costo dei fax in arrivo. Un record in coda può già contenere una stima. Né tale valore né una voce dell'elenco determinano la fatturazione definitiva.

created_at, sent_at e updated_at sono valori memorizzati nel formato del server, senza uno scostamento dal fuso orario; sent_at può essere null. L'elenco omette il campo relativo allo stato del webhook restituito dall'endpoint separato per lo stato.

Riconciliare i risultati delle pagine in sicurezza

Segui i valori di pagination.page, limit, total e total_pages. Le pagine oltre l'ultima possono essere vuote. Nuove operazioni possono spostare le voci da una pagina all'altra durante la consultazione. Conserva gli identificativi delle operazioni quando unisci i risultati di più pagine; questo endpoint non garantisce un'istantanea stabile dei dati.

Riservatezza e nuovi tentativi

I record dei fax in uscita contengono metadati telefonici riservati. Limita l'accesso in lettura ed evita di registrare le risposte complete nei log. L'assenza di una voce nell'elenco non dimostra che una richiesta di invio sia fallita: controlla l'identificativo dell'operazione conservato e la sezione dei fax in uscita del portale prima di ripetere l'invio. Un nuovo invio può creare un altro fax potenzialmente addebitabile. Le garanzie definitive sul processo esecutore, sulla fatturazione, sulle notifiche di richiamo e sulla conservazione dei dati sono ancora in fase di revisione.