Ανάγνωση συμβάντων έργου φορητότητας

Πρόσβαση στον λογαριασμό και στο έργο

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API μέσω HTTPS από επιτρεπόμενη διεύθυνση IP. Το έργο πρέπει να ανήκει σε αυτόν τον λογαριασμό και να μην έχει διαγραφεί. Χρησιμοποιήστε το μοναδικό αναγνωριστικό του έργου από τη ροή παραγγελίας φορητότητας, όχι το αριθμητικό αναγνωριστικό του στη βάση δεδομένων ή έναν αριθμό τηλεφώνου. Εφαρμόστε κωδικοποίηση URL στο αναγνωριστικό του έργου κατά τη δημιουργία ενός αιτήματος.

Αίτημα

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

Απόκριση

Πλασματικό παράδειγμα απόκρισης.

{
  "status": {
    "code": 200,
    "msg": "Project Events",
    "results": 1
  },
  "response": [
    {
      "id": 31,
      "subject": "Example project update",
      "event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
      "type": "comment",
      "value": "Example update",
      "source": "Example source",
      "date_created": "2026-10-23 12:00:00"
    }
  ]
}

Ένα υπάρχον έργο χωρίς συμβάντα επιστρέφει κωδικό API 200, κενή λίστα και status.results ίσο με 0. Τα αποτελέσματα ζητούνται κατά φθίνουσα σειρά χρόνου δημιουργίας, χωρίς πρόσθετη ταξινόμηση για ίδιους χρόνους δημιουργίας, σελιδοποίηση, δρομέα ή φίλτρο ημερομηνίας.

Διαβάστε προσεκτικά τα δεδομένα του συμβάντος

id είναι το αριθμητικό αναγνωριστικό της γραμμής του συμβάντος, subject είναι το αποθηκευμένο θέμα του και date_created είναι η αποθηκευμένη τιμή ημερομηνίας και ώρας του. Το τελικό σημείο διατηρεί την ακατέργαστη συμβολοσειρά event και επιχειρεί επίσης να αποκωδικοποιήσει τις ιδιότητές της type, value και source. Αν τα δεδομένα δεν είναι αντικείμενο JSON ή λείπει μια ιδιότητα, το αντίστοιχο πεδίο που προκύπτει από την ανάλυση είναι κενή συμβολοσειρά.

Τα δεδομένα δεν αποτελούν σταθερό σύνολο απαριθμημένων τιμών ούτε εγγυημένο σχήμα απλού κειμένου. Μην αντιμετωπίζετε το κείμενο της πηγής ως επαληθευμένη ταυτότητα και μην αποδίδετε το περιεχόμενο των συμβάντων ως HTML. Διατηρείτε τα ακατέργαστα συμβάντα σε εξουσιοδοτημένες ροές εργασίας στην πλευρά του διακομιστή και εμφανίζετε μόνο κατάλληλο κείμενο σε εξουσιοδοτημένους χρήστες. Αυτό το τελικό σημείο δεν διαθέτει ξεχωριστό φίλτρο ορατότητας συμβάντων για προσωπικό και πελάτες ούτε μηχανισμό απόκρυψης περιεχομένου.

Το ιστορικό δεν εγγυάται την παράδοση

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

Σφάλματα και όρια

Ελέγξτε τόσο την απόκριση HTTP όσο και τα status.code/status.msg. Ένα έργο που δεν υπάρχει, έχει διαγραφεί ή δεν ανήκει στον λογαριασμό επιστρέφει κωδικό API 404 με μήνυμα ότι το έργο δεν βρέθηκε. Ισχύουν επίσης ο έλεγχος ταυτότητας και οι περιορισμοί της διεύθυνσης IP προέλευσης. Τα παραδείγματα δεν εκτελούν πραγματικό αίτημα και μια επιτυχής απόκριση δεν αποδεικνύει ότι ένας πάροχος έχει αποδεχτεί ή ολοκληρώσει μια μεταφορά.

Επιδράσεις

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