Λίστα αριθμών ενός έργου φορητότητας

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

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

Αίτημα

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

Απόκριση

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

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

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

Πεδία αριθμών

Πεδία αριθμών προς μεταφορά
Πεδίο	Σημασία
id, number, isocode	Αριθμητικό αναγνωριστικό γραμμής, αποθηκευμένο κείμενο αριθμού τηλεφώνου και κωδικός χώρας. Το αναγνωριστικό της γραμμής δεν είναι το αναγνωριστικό του έργου.
status, status_str	Αριθμητική κατάσταση και η γνωστή ετικέτα της.
foc	Αποθηκευμένη τιμή προγραμματισμού της οριστικής δέσμευσης για την παραγγελία. Μπορεί να είναι κενή· ο χειριστής δεν τη μετατρέπει σε τεκμηριωμένη ζώνη ώρας ή μορφή χρονικής σήμανσης.
updated, date_created, date_completed	Αποθηκευμένες τιμές ενημέρωσης, δημιουργίας και ολοκλήρωσης. Χειριστείτε ρητά τις κενές τιμές· μην υποθέτετε μορφή ISO8601 και μην συνάγετε ζώνη ώρας από το πλασματικό παράδειγμα.
comment	Αποθηκευμένο σχόλιο που προορίζεται για τον πελάτη. Εμφανίστε το ως κείμενο και όχι ως εκτελέσιμο HTML.

Αυτή η αναπαράσταση παραλείπει το πεδίο internal_comment που προορίζεται μόνο για το προσωπικό. Αυτό δεν σημαίνει ότι η ξεχωριστή παλαιού τύπου αναζήτηση ενός αριθμού χρησιμοποιεί την ίδια αναπαράσταση.

Ταξινόμηση και παρακολούθηση

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

Ερμηνεία της κατάστασης φορητότητας

Γνωστές τιμές κατάστασης αριθμών
Τιμή	Ετικέτα
0	Pending
1	In Progress
2	Completed
9	Rejected

Διατηρήστε την αριθμητική κατάσταση και χειριστείτε τις άγνωστες τιμές. Για άγνωστες ετικέτες χρησιμοποιείται η αποθηκευμένη τιμή αντί να εγγυάται το σύστημα μια νέα ετικέτα. Μια αποθηκευμένη κατάσταση ολοκλήρωσης ή προγραμματισμένη ημερομηνία δεν αποτελεί από μόνη της δοκιμή της δρομολόγησης εισερχόμενων κλήσεων ή κάθε υπηρεσίας του αριθμού.

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

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

Επιπτώσεις

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