Ανάγνωση αποθηκευμένου πλάνου τιμών
Αναζητήστε τις γραμμές τιμών που έχουν αποθηκευτεί για τον λογαριασμό API σας αφού περιηγηθείτε στους διαθέσιμους τηλεφωνικούς αριθμούς. Χρησιμοποιήστε το uuid της επιλογής τιμής από τη λίστα price του επιλεγμένου αριθμού, όχι τον αριθμό του, το ID προθέματος ή το ID περιοχής. Κρατήστε μαζί τον επιλεγμένο αριθμό και την επιλογή τιμής.
Πρόκειται για αναζήτηση συμβατότητας αποθηκευμένων τιμών. Δεν ανανεώνει τη διαθεσιμότητα ή τις τιμές, δεν δεσμεύει αριθμό, δεν υποβάλλει παραγγελία και δεν εγγυάται το ποσό μιας μελλοντικής αγοράς. Ελέγξτε την επιλογή τιμής που επιστρέφεται με μια νέα αναζήτηση αριθμών πριν παραγγείλετε.
Αίτημα
Χρησιμοποιήστε τον ενεργοποιημένο λογαριασμό API σας μέσω HTTPS από επιτρεπόμενη διεύθυνση IP. Ορίστε το PRICE_ID στο ακριβές ID επιλογής τιμής που λάβατε. Η μέθοδος διαβάζει ένα όρισμα διαδρομής και καμία παράμετρο σώματος, ημερομηνίας ή σελιδοποίησης.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Η αναζήτηση αυτή πρέπει να γίνει από τον ίδιο λογαριασμό που έλαβε την επιλογή τιμής. Μην κατασκευάζετε ID, μην χρησιμοποιείτε αριθμό γραμμής βάσης δεδομένων και μην αντικαθιστάτε με την επιλογή άλλου λογαριασμού. Η παλαιού τύπου μέθοδος αντιστοιχίζει μόνο το ορατό ID τιμής.
Απόκριση
Το ακόλουθο φανταστικό παράδειγμα εμφανίζει μόνο επιλεγμένα πεδία που απευθύνονται στον πελάτη. Οι πραγματικές αποκρίσεις επιστρέφουν πλήρεις αποθηκευμένες γραμμές και μπορούν να περιλαμβάνουν πρόσθετα μεταδεδομένα λογαριασμού, προμηθευτή και εσωτερικής τιμολόγησης. Κρατήστε την πλήρη απόκριση στον διακομιστή σας και εκθέστε μόνο τις τιμές που απευθύνονται στον πελάτη και χρειάζεται η εφαρμογή σας.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response είναι λίστα, ακόμη και για μία γραμμή. Το status.results μετρά τις γραμμές που επιστρέφονται. Οι αριθμητικές τιμές της βάσης δεδομένων μπορεί να είναι συμβολοσειρές. Το endpoint δεν προσθέτει πεδίο νομίσματος ούτε μετατρέπει νομίσματα· επιβεβαιώστε το νόμισμα χρέωσης του λογαριασμού αντί να το συμπεράνετε από αυτό το παράδειγμα.
Πεδία τιμών
| Πεδίο | Σημασία |
|---|---|
| visible_uuid | Το ορατό αναγνωριστικό της αποθηκευμένης επιλογής τιμής. Χρησιμοποιήστε το αρχικό ID επιλογής κατά τη συσχέτιση της αναζήτησης. |
| setup_price | Αποθηκευμένη εφάπαξ τιμή ενεργοποίησης για αυτήν την επιλογή. |
| monthly_price | Αποθηκευμένη επαναλαμβανόμενη μηνιαία τιμή. |
| per_minute, free_minutes | Αποθηκευμένη χρέωση ανά λεπτό για εισερχόμενες κλήσεις και ποσότητα συμπεριλαμβανόμενων λεπτών. Δεν αποτελούν προσφορά για εξερχόμενες κλήσεις ούτε για κάθε πιθανή πρόσθετη χρέωση. |
| channels | Αποθηκευμένη ποσότητα καναλιών για αυτήν την επιλογή· δεν αποτελεί ζωντανό έλεγχο χωρητικότητας ή εγγραφής. |
| yearly_price | Ενδέχεται να υπάρχει ένα πρόσθετο αποθηκευμένο πεδίο ετήσιας τιμής. Μην συμπεραίνετε ότι μια μη μηδενική μηνιαία τιμή και ένα μηδενικό ετήσιο πεδίο αντιπροσωπεύουν δωρεάν ετήσιο πλάνο. |
Διαχείριση πολλαπλών γραμμών που ταιριάζουν
Μια αναζήτηση μπορεί να επιστρέψει περισσότερες από μία αποθηκευμένες γραμμές. Η μέθοδος δεν παρέχει εγγυημένη ταξινόμηση, επιλογή της πιο πρόσφατης γραμμής ή φίλτρο αριθμού/προθέματος. Μην επιλέγετε σιωπηρά την πρώτη ή την τελευταία γραμμή. Συγκρίνετε το επιστρεφόμενο πλαίσιο με τον αρχικά επιλεγμένο αριθμό και την επιλογή τιμής· αν παραμένει διφορούμενο ή παρωχημένο, ανανεώστε την αναζήτηση αριθμών αντί να αντιμετωπίζετε αυτήν την απόκριση ως προσφορά παραγγελίας.
Η ροή εργασίας ελέγχου παραγγελίας της πύλης εκτελεί πρόσθετους ελέγχους επιλογής και εγκυρότητας. Μην υποθέτετε ότι αυτή η παλαιού τύπου αναζήτηση υλοποιεί αυτούς τους ελέγχους ή ότι δέχεται κάθε αναγνωριστικό που δέχεται η πύλη.
Κενές αποκρίσεις και σφάλματα
Αν καμία αποθηκευμένη γραμμή δεν ταιριάζει, ο τρέχων χειριστής δεν εκπέμπει κανένα αποτέλεσμα JSON και καμία ρητή απόκριση «δεν βρέθηκε». Ένα κενό σώμα δεν σημαίνει μηδενική τιμή, διαθέσιμο πλάνο ή επιβεβαιωμένη επιτυχή αναζήτηση. Ελέγξτε τόσο την απόκριση HTTP όσο και τη δομή JSON· μην παραγγέλνετε με βάση δεδομένα τιμών που λείπουν ή δεν μπορούν να αναλυθούν.
Ο έλεγχος ταυτότητας, οι περιορισμοί διεύθυνσης IP προέλευσης και οι αστοχίες της βάσης δεδομένων μπορούν επίσης να εμποδίσουν μια χρησιμοποιήσιμη απόκριση. Δεν υπάρχει ειδικός για τον χειριστή φάκελος σφάλματος για εξαίρεση βάσης δεδομένων. Ανανεώστε την επιλογή σας ή επικοινωνήστε με την υποστήριξη όταν μια αναζήτηση με έλεγχο ταυτότητας παραμένει μη διαθέσιμη.
Επιδράσεις και όρια
Η αναζήτηση που εξετάστηκε εκτελεί ένα ερώτημα ανάγνωσης και δεν περιλαμβάνει χρέωση, αγορά, δέσμευση ή ανανέωση τιμών παρόχου. Η ανάγνωση αποθηκευμένων τιμών δεν τεκμηριώνει τρέχον απόθεμα, κανονιστική έγκριση, δικαίωμα αγοράς του λογαριασμού ή τελική χρέωση.