Προβολή εργασιών εξερχόμενων φαξ

Προβολή εργασιών εξερχόμενων φαξ

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API της MultiTEL μέσω HTTPS, με τα διαπιστευτήρια και τους περιορισμούς IP που έχουν ρυθμιστεί για αυτόν. Αυτό το τελικό σημείο παραθέτει τις εγγραφές εξερχόμενων φαξ που ανήκουν στον λογαριασμό του οποίου η ταυτότητα έχει επαληθευτεί. Η προβολή της λίστας δεν μεταδίδει ούτε επαναποστέλλει φαξ.

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

Αυτός ο χειριστής δεν υποστηρίζει φίλτρα date_from ή date_to. Η ενότητα εξερχόμενων της πύλης διαθέτει πρόσθετα φίλτρα που δεν πρέπει να αντιγράφονται σε αυτό το αίτημα API. Τα αποτελέσματα ταξινομούνται κατά χρόνο δημιουργίας, με τα νεότερα πρώτα, χωρίς δευτερεύουσα ταξινόμηση κατά αναγνωριστικό ή δρομέα σελιδοποίησης που βασίζεται σε στιγμιότυπο.

Ανάγνωση εγγραφών εργασιών

Ελέγξτε τόσο το αποτέλεσμα HTTP όσο και το πεδίο status.code στο JSON. Μια επιτυχής απόκριση περιέχει response.faxes και response.pagination· το παράδειγμα χρησιμοποιεί πλασματικά δεδομένα. Ένα κενό γραμματοκιβώτιο επιστρέφει έναν κενό πίνακα faxes με total ίσο με 0 και total_pages ίσο με 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 είναι το αριθμητικό αναγνωριστικό της εγγραφής. uuid είναι το ορατό αναγνωριστικό της εργασίας· για νέες υποβολές χρησιμοποιήστε το αναγνωριστικό εργασίας που επιστρέφει το send_fax και διατηρήστε το για τον περιοδικό έλεγχο κατάστασης. Η λίστα μπορεί να περιλαμβάνει παλαιότερες εγγραφές, επομένως μην υποθέτετε ότι κάθε γραμμή δημιουργήθηκε μέσω του ίδιου τελικού σημείου υποβολής.

status και result_text περιέχουν την καταγεγραμμένη κατάσταση επεξεργασίας και το καταγεγραμμένο μήνυμα. Αυτή η λίστα δεν τα κανονικοποιεί σε ένα πλήρες σύνολο απαριθμημένων καταστάσεων παράδοσης. Η ένδειξη σε αναμονή σημαίνει ότι το φαξ βρίσκεται στην ουρά, όχι ότι παραδόθηκε. Για κρίσιμα έγγραφα, επιβεβαιώστε την παραλαβή με τον παραλήπτη πριν θεωρήσετε το φαξ παραδομένο ή υποβάλετε αντίγραφό του.

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

created_at, sent_at και updated_at είναι αποθηκευμένες τιμές στη μορφή του διακομιστή, χωρίς μετατόπιση ζώνης ώρας· το sent_at μπορεί να είναι null. Η λίστα παραλείπει το πεδίο κατάστασης του webhook που επιστρέφεται από το ξεχωριστό τελικό σημείο κατάστασης.

Ασφαλής αντιπαραβολή αποτελεσμάτων σελίδων

Ακολουθήστε τις τιμές των pagination.page, limit, total και total_pages. Οι σελίδες μετά την τελευταία μπορεί να είναι κενές. Νέες εργασίες μπορούν να μετακινήσουν καταχωρίσεις μεταξύ σελίδων κατά την περιήγησή σας. Διατηρήστε τα αναγνωριστικά εργασιών όταν συνδυάζετε αποτελέσματα από διαφορετικές σελίδες· αυτό το τελικό σημείο δεν εγγυάται σταθερό στιγμιότυπο των δεδομένων.

Απόρρητο και επαναλήψεις προσπαθειών

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