Usa HTTPS e l'autenticazione HTTP Basic con credenziali API approvate. Conserva le credenziali sul server della tua applicazione. Questi endpoint Hosted PBX usano /hpbx/ su api.multitel.net; non inserire /v3. Controlla sia il risultato HTTP sia lo stato applicativo nella risposta JSON.
Leggi i record fax
curl --request POST --user "USERNAME:PASSWORD" \
"https://api.multitel.net/hpbx/fax/list/YOUR_BILLING_CODE"Sostituisci il codice di fatturazione con quello del tuo PBX. I record restituiti includono ora del fax, direzione, origine, destinazione, stato di consegna, tentativi, errori e numero di pagine. La consegna può risultare ancora in sospeso quando una richiesta di invio viene accettata.
Parametri di invio
L'endpoint di invio è POST /hpbx/fax/send/{billing_code}. L’invio esegue un’operazione reale. Prepara il file e la destinazione autorizzata dall'account prima di inviare; non riprovare ciecamente un invio incerto.
| Campo | Significato |
|---|---|
| number | Numero fax di destinazione. |
| cidnum | ID chiamante approvato per il mittente. |
| schedule | Ora di invio programmata, quando utilizzata. |
| faxquality / pagesize / pagerotate | Opzioni supportate di qualità, formato carta e rotazione. |
| statusemail | Indirizzo autorizzato per le notifiche di consegna. |
| deleteaftersend | Indica se il file caricato e memorizzato debba essere rimosso dopo l'invio. |
| filename | Il riferimento al documento previsto da questo flusso di lavoro fax; non è un percorso di file locale arbitrario. |
Monitora il completamento
Dopo l'invio, controlla lo stato, i tentativi e l'errore del record del fax. Conferma la consegna invece di considerare l'accettazione come consegna. Il riferimento fax del portale documenta il flusso di caricamento e invio attuale; i relativi percorsi e l'autenticazione sono separati dall'endpoint sopra indicato.