Αυτή η συνάρτηση σάς επιτρέπει να αγοράσετε έναν αριθμό τηλεφώνου.
Αν θέλετε να κρατάτε τα πράγματα απλά, αρκεί να ορίσετε ένα προεπιλεγμένο URI ringto (https://www.multitel.net/auth/setting , στην καρτέλα «URI Settings» (ρυθμίσεις URI)) και στη συνέχεια να καλέσετε τη διεύθυνση URL παρακάτω:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Μια επιτυχής κλήση API θα επιστρέψει το ακόλουθο μήνυμα:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Μια ανεπιτυχής κλήση στο API θα επιστρέψει ένα από τα ακόλουθα μηνύματα:
{"DATA":[{"RETURN":99}]} <== not enough balance to purchase number{"DATA":[{"RETURN":100}]} <== not authenticated (Check username/password){"DATA":[{"RETURN":-165}]} <== number has already been sold (check your account, possibly you hit the refresh button twice and you already purchased the number?){"DATA":[{"RETURN":-220}]} <== number is reserved (might happen when number was just released, please try again in a few minutes){"DATA":[{"RETURN":-275}]} <== this number does not exist in our inventory anymore{"DATA":[{"RETURN":-1210}]} <== number not cleared{"DATA":[{"RETURN":-1265}]} <== documentation required - usually proof of address / ID card copy (please contact us for more info.Εάν χρειάζεται να καθορίσετε περισσότερες παραμέτρους, συνεχίστε την ανάγνωση:
POST URL: https://api.multitel.net/json/buynumbers/
Παράμετροι POST:
| UserName | Το όνομα χρήστη σύνδεσής σας ή το όνομα χρήστη API σας |
| Password | Ο κωδικός πρόσβασης σύνδεσής σας ή ο κωδικός πρόσβασης API σας |
| Number | Ο αριθμός τηλεφώνου που θέλετε να αγοράσετε |
| Description | Σύντομη περιγραφή (αν δεν δοθεί, χρησιμοποιείται από προεπιλογή η τιμή του πεδίου Number) |
| Type | Ισοδύναμο με το «Προορισμός προώθησης (Forward Destination)» από τη διεπαφή ιστού. Πιθανές τιμές είναι: 1 (για SIP) ή 2 (για Dial) |
| RingType | 1 για Διαδοχική, 2 για Τυχαία, 3 για Ταυτόχρονη |
| Ringstyle | 1 για κουδούνισμα (Ring), 2 για μουσική (Early Media) |
| URI | Πρώτο SIP URI για κουδούνισμα (ή αριθμός τηλεφώνου προς κλήση -- χωρίς πρόθεμα 00/011/+ παρακαλώ) |
| URI2 | Δεύτερο SIP URI προς κλήση |
| URI3 | Τρίτο SIP URI προς κλήση |
| SMSRingType | 1 για email, 2 για αποστολή αιτήματος POST σε URL |
| SMSURI | είτε τη διεύθυνση E-Mail είτε το URL POST |
| FaxDetect | 1 για ενεργοποίηση, 0 για απενεργοποίηση. Αν δεν οριστεί, η προεπιλογή είναι 0 |
| FaxEmail | Email στο οποίο θα προωθείται το φαξ |
| FaxRing | Για πόσα δευτερόλεπτα πρέπει να ακούμε για τόνους φαξ; Προεπιλογή 5 |
| Vm | Ενεργοποιημένος τηλεφωνητής; Πιθανές τιμές 1 ή 0 |
| Vmring | Πόσα δευτερόλεπτα περνούν πριν ενεργοποιηθεί το φωνητικό ταχυδρομείο (VM) |
| Vms2t | Μετατροπή φωνής τηλεφωνητή σε κείμενο (Voicemail Speech 2 Text) -- 1 για ενεργοποίηση, 0 για απενεργοποίηση |
| Vmemail | Διεύθυνση email όπου θα προωθούνται τα φωνητικά μηνύματα |
| Cnam | Ενεργοποίηση αναζητήσεων CNAM (πιθανές τιμές 0 ή 1 - προεπιλογή 0) |
| Record | Εγγραφή των τηλεφωνικών συνομιλιών (0 ή 1, προεπιλογή 0) |
| Screening | Φιλτράρισμα καλούντων (ζητείται από αυτούς να συστηθούν πριν συνδεθούν - πιθανές τιμές 0 ή 1, προεπιλογή 0 |
| Channels | Πόσα κανάλια χρειαζόμαστε; Η προεπιλογή είναι 2, εκτός αν ο αριθμός έχει διαθέσιμο μόνο 1 κανάλι. Λάβετε υπόψη ότι για αριθμούς μόνο SMS (αριθμοί χωρίς δυνατότητα VoIP) αυτή η ρύθμιση δεν έχει καμία επίδραση, επομένως μην την ορίζετε αν δεν τη χρειάζεστε. |
| Atcd | Αυτόματη ανίχνευση κλήσεων τηλεμάρκετινγκ -- λειτουργία που ανιχνεύει αυτοματοποιημένες/ρομποτικές κλήσεις και τερματίζει την κλήση εάν εντοπιστεί τέτοια κλήση. Πιθανές τιμές 1 ή 0, προεπιλογή 0 |
| SID | Αναγνωριστικό υπολογαριασμού (Sub Account ID) — ορίστε τους υπολογαριασμούς σας στο https://www.multitel.net/auth/setting/ στην καρτέλα Υπολογαριασμοί (SubAccounts) |
URL για GET:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... κ.λπ.
Λάβετε υπόψη ότι οι παράμετροι που χρησιμοποιούνται για το GET είναι ακριβώς οι ίδιες με τις παραμέτρους που χρησιμοποιούνται για το POST και θα πρέπει να χρησιμοποιούνται με την ακριβή σειρά με την οποία αναφέρονται στο
τον παραπάνω πίνακα.
Συνιστούμε ανεπιφύλακτα να χρησιμοποιείτε POST αντί για GET, καθώς ελαχιστοποιεί τον κίνδυνο αντιμετάθεσης παραμέτρων.