Verifica lo stato del lavoro fax

Cerca il tuo lavoro

Usa un account MultiTEL API abilitato. Invia credenziali HTTP Basic per un account con password, oppure un token Bearer per un account con token. Le autorizzazioni dell'account e le restrizioni IP continuano ad applicarsi. Non utilizzare credenziali worker interne.

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

job_id è obbligatorio e deve essere l'identificatore esadecimale di 32 caratteri restituito da send_fax. Copialo esattamente. Le richieste sono limitate al proprietario autenticato.

Leggi il risultato

Leggi sia il risultato HTTP sia JSON status.code. Errori JSON possono arrivare con HTTP 200. Una risposta JSON riuscita contiene status e response; gli esempi utilizzano dati fittizi.

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

L'esempio è un lavoro in coda, non un fax consegnato né un preventivo di prezzo. pages_requested è il conteggio rilevato delle pagine di origine; pages_sent riporta l'avanzamento registrato dall'elaborazione. cost è una stringa decimale e potrebbe già contenere una stima mentre è in coda. result riporta i dettagli dell'elaborazione; webhook_status riporta lo stato registrato della richiamata. I timestamp sono stringhe formattate dal server senza offset di fuso orario.

Esegui il polling con intervalli crescenti anziché in un ciclo stretto. L'elaborazione può segnalare uno stato inviato o completato, ma la verifica attuale non ha stabilito una garanzia di consegna al destinatario. Per un documento critico, conferma la ricezione con il destinatario prima di considerarlo consegnato o di inviare un duplicato. Il ciclo di vita attivo del worker, le regole di fatturazione finali e il contratto di callback sono ancora in fase di verifica. Non presumere che l'accettazione in coda o un ID lavoro non vuoto significhi consegna.

Errori

Il codice API 400 indica job_id mancante o non valido; 401 indica autenticazione mancante; 404 indica che il lavoro non è stato trovato per questo account. Non dedurre la proprietà dal solo identificatore.