Έλεγχος κατάστασης εργασίας φαξ

Αναζητήστε την εργασία σας

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό MultiTEL API. Στείλτε διαπιστευτήρια HTTP Basic για λογαριασμό με κωδικό πρόσβασης ή διακριτικό Bearer για λογαριασμό με διακριτικό. Τα δικαιώματα λογαριασμού και οι περιορισμοί IP εξακολουθούν να ισχύουν. Μην χρησιμοποιείτε εσωτερικά διαπιστευτήρια 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 είναι υποχρεωτικό και πρέπει να είναι το δεκαεξαδικό αναγνωριστικό 32 χαρακτήρων που επιστράφηκε από send_fax. Αντιγράψτε το ακριβώς. Τα αιτήματα περιορίζονται στον αυθεντικοποιημένο κάτοχο.

Διαβάστε το αποτέλεσμα

Διαβάστε τόσο το αποτέλεσμα HTTP όσο και το JSON status.code. Αποτυχίες JSON ενδέχεται να φτάσουν με HTTP 200. Μια επιτυχής απόκριση JSON περιέχει status και response· τα παραδείγματα χρησιμοποιούν πλασματικά δεδομένα.

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

Το παράδειγμα είναι μια εργασία σε ουρά, όχι ένα παραδοθέν φαξ ούτε μια προσφορά τιμής. pages_requested είναι ο ανιχνευμένος αριθμός σελίδων προέλευσης· pages_sent αναφέρει την πρόοδο που καταγράφηκε από την επεξεργασία. cost είναι δεκαδική συμβολοσειρά και ενδέχεται να περιέχει ήδη μια εκτίμηση ενώ βρίσκεται σε ουρά. result φέρει λεπτομέρειες επεξεργασίας· webhook_status φέρει την καταγεγραμμένη κατάσταση επιστροφής κλήσης. Οι χρονικές σημάνσεις είναι συμβολοσειρές μορφοποιημένες από τον διακομιστή χωρίς μετατόπιση ζώνης ώρας.

Υποβάλετε ερωτήματα με αυξανόμενα διαστήματα αντί για στενό βρόχο. Η επεξεργασία μπορεί να αναφέρει κατάσταση απεσταλμένου ή ολοκληρωμένου, αλλά ο τρέχων έλεγχος δεν έχει τεκμηριώσει εγγύηση παράδοσης στον παραλήπτη. Για κρίσιμο έγγραφο, επιβεβαιώστε τη λήψη με τον παραλήπτη πριν το θεωρήσετε παραδοθέν ή στείλετε διπλότυπο. Ο ενεργός κύκλος ζωής worker, οι τελικοί κανόνες χρέωσης και η σύμβαση επιστροφής κλήσης εξακολουθούν να επαληθεύονται. Μην υποθέτετε ότι η αποδοχή στην ουρά ή ένα μη κενό αναγνωριστικό εργασίας σημαίνει παράδοση.

Σφάλματα

Ο κωδικός API 400 σημαίνει ότι λείπει ή είναι κακοσχηματισμένο το job_id· το 401 σημαίνει έλλειψη ελέγχου ταυτότητας· το 404 σημαίνει ότι η εργασία δεν βρέθηκε για αυτόν τον λογαριασμό. Μην συμπεραίνετε την κυριότητα μόνο από το αναγνωριστικό.