Λίστα ληφθέντων φαξ

Λίστα ληφθέντων φαξ

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

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

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

Ανάγνωση σελίδας εισερχομένων

Ελέγξτε το αποτέλεσμα HTTP και το πεδίο status.code στο περιεχόμενο JSON. Σφάλματα σε άλλα σημεία του API μπορούν να επιστρέφονται μέσα σε δομή σφάλματος JSON, ακόμη και όταν η κατάσταση HTTP είναι 200. Μια επιτυχής απόκριση περιέχει response.faxes και response.pagination. Αυτό το παράδειγμα χρησιμοποιεί πλασματικές τιμές.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id είναι το αριθμητικό αναγνωριστικό της εγγραφής εισερχομένων. hash είναι η αναπαράστασή του σε MD5 για την παλαιότερη ροή εργασίας εισερχόμενων εγγράφων· δεν είναι αναγνωριστικό εργασίας send_fax ούτε διαπιστευτήριο εξουσιοδότησης. Μην το χρησιμοποιείτε με το τελικό σημείο fax_status για εξερχόμενα φαξ.

received_timestamp είναι η αποθηκευμένη χρονική σήμανση Unix. received_at είναι μια χρονική σήμανση μορφοποιημένη από τον διακομιστή χωρίς μετατόπιση ζώνης ώρας, ή null αν δεν έχει καταγραφεί χρόνος λήψης· χρησιμοποιήστε την τιμή Unix κατά την εμφάνιση ωρών στη δική σας ζώνη ώρας. cost είναι αριθμός JSON, όχι προσφορά τιμής ούτε απόδειξη ξεχωριστής ολοκληρωμένης χρέωσης.

status έχει την τιμή success μόνο όταν ο αποθηκευμένος κωδικός κατάστασης είναι μηδέν· οι άλλες τιμές γίνονται failed. status_text περιέχει το αποθηκευμένο μήνυμα επεξεργασίας, με εναλλακτική τιμή OK ή Failed. emailed διατηρεί την αποθηκευμένη τιμή αντί για λογική τιμή. viewed είναι λογική τιμή. Μην συμπεραίνετε ότι το μήνυμα ηλεκτρονικού ταχυδρομείου παραδόθηκε επιτυχώς μόνο από την κατάσταση του φαξ.

Χειρισμός κενών λιστών και λιστών που μεταβάλλονται

Ένα κενό γραμματοκιβώτιο επιστρέφει κενό πίνακα faxes, total με τιμή 0 και total_pages με τιμή 0. Μια σελίδα μετά την τελευταία μπορεί επίσης να επιστρέψει κενό πίνακα. Σταματήστε σύμφωνα με τα πεδία σελιδοποίησης αντί να υποθέτετε ότι υπάρχει τουλάχιστον μία σελίδα. Δεν παρέχεται δρομέας ούτε δευτερεύουσα ταξινόμηση κατά αναγνωριστικό εγγραφής. Διατηρείτε τα αναγνωριστικά εγγραφών όταν συμφιλιώνετε επικαλυπτόμενες σελίδες.

Πρόσβαση σε έγγραφα και απόρρητο

Οι εγγραφές εισερχομένων περιέχουν απόρρητα μεταδεδομένα τηλεφωνίας και εγγράφων. Περιορίστε την πρόσβαση στην εφαρμογή σας και αποφύγετε την καταγραφή ολόκληρων αποκρίσεων στα αρχεία καταγραφής. Η εμφάνιση της λίστας δεν επισημαίνει ένα έγγραφο ως προβληθέν. Χρησιμοποιήστε το fax_file για τη λήψη εισερχόμενων εγγράφων μέσω της λειτουργίας συμβατότητας, έχοντας υπόψη ότι επισημαίνει μια υπάρχουσα εγγραφή εισερχομένων ως προβληθείσα ακόμη και αν το αρχείο της δεν είναι διαθέσιμο. Η πρόσβαση στα έγγραφα είναι επίσης δυνατή από τα εισερχόμενα της πύλης. Δεν έχει καθοριστεί καμία εγγύηση διατήρησης αρχείων.