ეს ფუნქცია საშუალებას მოგცემთ შეიძინოთ ტელეფონის ნომერი.
თუ გსურთ ყველაფერი მარტივად შეინარჩუნოთ, საკმარისია განსაზღვროთ ნაგულისხმევი ringto URI (https://www.multitel.net/auth/setting , ჩანართში „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წარუმატებელი ზარი დააბრუნებს ერთ-ერთ შემდეგ შეტყობინებას:
{"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 | ვებ ინტერფეისის "გადამისამართების დანიშნულება"-ის ექვივალენტია. შესაძლო მნიშვნელობებია: 1 (SIP-ისთვის) ან 2 (Dial-ისთვის) |
| RingType | 1 — თანმიმდევრობით დარეკვა, 2 — შემთხვევითი არჩევით დარეკვა, 3 — ერთდროულად დარეკვა |
| Ringstyle | 1 — ზარის სიგნალი, 2 — მუსიკა (ადრეული მედია) |
| URI | პირველი SIP URI, რომელზეც უნდა დარეკოს (ან სატელეფონო ნომერი აკრეფისთვის -- გთხოვთ, 00/011/+ პრეფიქსის გარეშე) |
| URI2 | მეორე SIP URI, რომელზეც უნდა დარეკოს |
| URI3 | დასარეკი მესამე SIP URI |
| SMSRingType | 1 ელფოსტისთვის, 2 URL-ზე POST მოთხოვნისთვის |
| SMSURI | ელფოსტის მისამართი ან POST მოთხოვნის URL |
| FaxDetect | 1 ჩართულია, 0 გამორთულია. თუ არ არის მითითებული, ნაგულისხმევი მნიშვნელობაა 0 |
| FaxEmail | ელფოსტა, სადაც ფაქსი უნდა გადაიგზავნოს |
| FaxRing | რამდენი წამი უნდა ვუსმინოთ ფაქსის ტონებს? ნაგულისხმევია 5 |
| Vm | ხმოვანი ფოსტა ჩართულია? შესაძლო მნიშვნელობებია 1 ან 0 |
| Vmring | რამდენი წამის შემდეგ ჩაირთვება ხმოვანი ფოსტა (VM) |
| Vms2t | ხმოვანი ფოსტის მეტყველების ტექსტად გარდაქმნა (Speech 2 Text) -- 1 ჩართვისთვის, 0 გამორთვისთვის |
| Vmemail | ელფოსტის მისამართი, რომელზეც ხმოვანი ფოსტა უნდა გადაიგზავნოს |
| Cnam | CNAM-ის მოძიების ჩართვა (შესაძლო მნიშვნელობებია 0 ან 1 - ნაგულისხმევია 0) |
| Record | სატელეფონო საუბრების ჩაწერა (0 ან 1, ნაგულისხმევია 0) |
| Screening | გაფილტრეთ მრეკელები (სთხოვეთ მათ იდენტიფიკაცია დაკავშირებამდე - შესაძლო მნიშვნელობები 0 ან 1, ნაგულისხმევია 0 |
| Channels | რამდენი არხი გვჭირდება? ნაგულისხმევი მნიშვნელობაა 2, გარდა იმ შემთხვევისა, როცა ნომერზე მხოლოდ 1 არხია ხელმისაწვდომი. გაითვალისწინეთ, რომ მხოლოდ SMS-ის ნომრებზე (რომლებსაც VoIP შესაძლებლობა არ აქვთ) ამ პარამეტრს გავლენა არ აქვს, ამიტომ საჭიროების გარეშე ნუ დააყენებთ. |
| Atcd | ტელემარკეტერის ზარის ავტომატური გამოვლენა -- ფუნქცია, რომელიც უსმენს ავტომატურ/რობოტულ ზარებს და თუ ასეთი ზარი გამოვლინდა, წყვეტს ზარს. შესაძლო მნიშვნელობებია 1 ან 0, ნაგულისხმევია 0 |
| SID | ქვეანგარიშის ID -- განსაზღვრეთ თქვენი ქვეანგარიშები აქ: https://www.multitel.net/auth/setting/, ქვეანგარიშების ჩანართში |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... და ა.შ.
გთხოვთ გაითვალისწინოთ, რომ GET-ისთვის გამოყენებული პარამეტრები ზუსტად იგივეა, რაც POST-ისთვის გამოყენებული პარამეტრები, და ისინი უნდა იქნეს გამოყენებული ზუსტად იმ თანმიმდევრობით, როგორც ჩამოთვლილია
ზემოთ მოცემული ცხრილი.
დაჟინებით გირჩევთ GET-ის ნაცვლად POST გამოიყენოთ, რადგან ეს პარამეტრების აღრევის რისკს ამცირებს.