Verificați starea lucrării de fax

Căutați lucrarea dvs.

Utilizați un cont MultiTEL API activat. Trimiteți acreditări HTTP Basic pentru un cont cu parolă sau un jeton Bearer pentru un cont cu jeton. Permisiunile contului și restricțiile IP se aplică în continuare. Nu utilizați acreditări interne 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 este obligatoriu și trebuie să fie identificatorul hexazecimal de 32 de caractere returnat de send_fax. Copiați-l exact. Solicitările sunt limitate la proprietarul autentificat.

Citiți rezultatul

Citiți atât rezultatul HTTP, cât și JSON status.code. Eșecurile JSON pot sosi cu HTTP 200. Un răspuns JSON reușit conține status și response; exemplele folosesc date fictive.

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

Exemplul este o lucrare aflată în coadă, nu un fax livrat sau o ofertă de preț. pages_requested este numărul detectat de pagini sursă; pages_sent raportează progresul înregistrat de procesare. cost este un șir zecimal și poate conține deja o estimare în timp ce se află în coadă. result conține detalii de procesare; webhook_status conține starea înregistrată a apelului invers. Marcajele temporale sunt șiruri formatate de server, fără decalaj de fus orar.

Interogați cu intervale crescătoare, mai degrabă decât într-o buclă strânsă. Procesarea poate raporta o stare trimisă sau finalizată, dar auditul actual nu a stabilit o garanție de livrare către destinatar. Pentru un document critic, confirmați primirea cu destinatarul înainte de a-l considera livrat sau de a trimite un duplicat. Ciclul de viață activ al workerului, regulile finale de facturare și contractul de apel invers sunt încă în curs de verificare. Nu presupuneți că acceptarea în coadă sau un ID de lucrare nevid înseamnă livrare.

Erori

Codul API 400 înseamnă job_id lipsă sau formatat greșit; 401 înseamnă autentificare lipsă; 404 înseamnă că lucrarea nu a fost găsită pentru acest cont. Nu deduceți proprietatea doar din identificator.