Υποβολή καταχώρισης αριθμού σε τηλεφωνικό κατάλογο

Υποβολή καταχώρισης στον κατάλογο του παρόχου

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

Υποβάλετε μόνο στοιχεία για τα οποία ο πελάτης έχει δώσει άδεια καταχώρισης σε κατάλογο. Επιβεβαιώστε ότι ο πάροχος υποστηρίζει τον αριθμό πριν χρησιμοποιήσετε αυτή τη διαδρομή του παλαιού συστήματος. Ο χειριστής που εξετάστηκε δεν ελέγχει την επιλεξιμότητα του παρόχου ούτε τη διεθνή μορφή του αριθμού· το αίτημά του προς τον πάροχο θεωρεί δεδομένο ότι πρόκειται για αριθμό Βόρειας Αμερικής και αφαιρεί το πρώτο αποθηκευμένο ψηφίο.

Απαιτήσεις λογαριασμού και αριθμού

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API μέσω HTTPS από επιτρεπόμενη διεύθυνση IP προέλευσης. Ο ακριβής αριθμός πρέπει να αντιστοιχεί σε μη ακυρωμένη εγγραφή αγορασμένου αριθμού που ανήκει σε αυτόν τον λογαριασμό. Χρησιμοποιήστε όλα τα ψηφία της διεθνούς μορφής από το απόθεμά σας, όπως τη μορφή με κωδικό χώρας 1 για έναν υποστηριζόμενο αριθμό Βόρειας Αμερικής. Μη χρησιμοποιείτε αναγνωριστικό τιμολογιακού προγράμματος, UUID αριθμού ή αριθμό που ανήκει σε άλλον λογαριασμό.

Αίτημα POST με δεδομένα φόρμας

Ορίστε το NUMBER στον αριθμό που σας ανήκει. Αντικαταστήστε το φανταστικό παράδειγμα με τα εξουσιοδοτημένα στοιχεία καταχώρισης. Αυτή η διαδρομή διαβάζει πεδία φόρμας από POST· δεν αναλύει σώμα application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

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

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

Χρέωση και συμπεριφορά επανάληψης αιτημάτων

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

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

Απόκριση

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

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

Σφάλματα του παλαιού συστήματος

Διαβάστε τόσο την κατάσταση HTTP όσο και τα πεδία του JSON status.code/status.msg. Η ταυτοποίηση και οι περιορισμοί της IP προέλευσης μπορούν επίσης να εμποδίσουν τη λήψη αξιοποιήσιμης απόκρισης. Μη χρησιμοποιείτε GET ή παραμέτρους ερωτήματος για να ζητήσετε ενημέρωση μόνο και μόνο επειδή ο χειριστής του παλαιού συστήματος δεν διαθέτει ρητό έλεγχο της μεθόδου HTTP.

Επαληθεύστε πριν δοκιμάσετε ξανά

1. Πριν στείλετε το αίτημα, επιβεβαιώστε τον αριθμό που σας ανήκει, την επιλεξιμότητα του παρόχου, τα εξουσιοδοτημένα στοιχεία καταχώρισης και τη χρέωση.
2. Υποβάλετε μία φορά και διατηρήστε το αποτέλεσμα από την πλευρά του λογαριασμού, χωρίς να εκθέτετε τη διεύθυνση του πελάτη σε δημόσια αρχεία καταγραφής ή συστήματα ανάλυσης.
3. Ελέγξτε την αποθηκευμένη καταχώριση και το ιστορικό συναλλαγών μέσω της υποστηριζόμενης διαδικασίας του λογαριασμού ή της υποστήριξης. Περιμένετε τον χρόνο επεξεργασίας που έχει επιβεβαιώσει ο πάροχος· αυτό το API δεν ορίζει εγγυημένη προθεσμία διάδοσης.
4. Όταν το αποτέλεσμα είναι αβέβαιο, ζητήστε από την υποστήριξη να αντιπαραβάλει και να διευκρινίσει την παραγγελία στον πάροχο και την τοπική χρέωση πριν δοκιμάσετε ξανά. Ένα επαναλαμβανόμενο αίτημα δεν αποτελεί ιδιοδύναμο έλεγχο κατάστασης.