Bu işlev bir telefon numarası satın almanızı sağlar.
İşleri basit tutmayı tercih ediyorsanız, tek yapmanız gereken varsayılan bir ringto URI’si (gelen arama hedefi) tanımlamak (https://www.multitel.net/auth/setting , “URI Settings (URI ayarları)” sekmesinde) ve ardından aşağıdaki URL’yi çağırmaktır:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Başarılı bir API çağrısı şu mesajı döndürür:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Başarısız bir API çağrısı aşağıdaki mesajlardan birini döndürür:
{"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.Daha fazla parametre belirtmeniz gerekiyorsa, okumaya devam edin:
POST URL: https://api.multitel.net/json/buynumbers/
POST Parametreleri:
| UserName | Oturum açma Kullanıcı Adınız veya API Kullanıcı Adınız |
| Password | Oturum açma parolanız veya API parolanız |
| Number | Satın almak istediğiniz telefon numarası |
| Description | Kısa açıklama (belirtilmezse varsayılan olarak Number alanının değeri kullanılır) |
| Type | Web arayüzündeki “Forward Destination” (yönlendirme hedefi) ile eşdeğerdir. Olası değerler: 1 (SIP için) veya 2 (Dial, yani numara çevirme için) |
| RingType | Sıralı için 1, Rastgele için 2, Eşzamanlı için 3 |
| Ringstyle | Çalma sesi için 1, Müzik için 2 (Early Media – çağrı yanıtlanmadan önceki ses) |
| URI | Çalacak ilk SIP URI (veya aranacak telefon numarası -- lütfen 00/011/+ öneki olmadan) |
| URI2 | Çaldırılacak ikinci SIP URI'si |
| URI3 | Çalınacak üçüncü SIP URI |
| SMSRingType | E-posta için 1, URL’ye POST isteği göndermek için 2 |
| SMSURI | ya E-posta adresi ya da POST url |
| FaxDetect | Etkin için 1, devre dışı için 0 . Belirtilmezse varsayılan değer 0'dır |
| FaxEmail | Faksın iletileceği e-posta |
| FaxRing | Faks tonlarını kaç saniye dinlemeliyiz? Varsayılan 5'tir |
| Vm | Sesli posta etkin mi ? Olası değerler 1 veya 0 |
| Vmring | Sesli mesajın devreye girmesinden önce kaç saniye geçmeli |
| Vms2t | Sesli Mesaj Konuşmadan Metne (Speech 2 Text) -- etkin için 1, devre dışı için 0 |
| Vmemail | Sesli Postaların yönlendirileceği E-posta adresi |
| Cnam | CNAM sorgularını etkinleştirin (olası değerler 0 veya 1 - varsayılan olarak 0) |
| Record | Telefon görüşmelerini kaydet (0 veya 1, varsayılan 0'dır) |
| Screening | Arayanlardan, bağlanmadan önce kendilerini tanıtmalarını isteyin (olası değerler 0 veya 1, varsayılan 0). |
| Channels | Kaç kanala ihtiyacımız var? Numaranın yalnızca 1 kullanılabilir kanalı yoksa varsayılan olarak 2'dir. Lütfen yalnızca SMS numaraları (VoIP yeteneği olmayan Numaralar) için bu ayarın etkisiz olduğunu unutmayın, bu nedenle ihtiyacınız olmayacaksa ayarlamayın. |
| Atcd | Otomatik Telepazarlama Çağrı Tespiti -- otomatik/robot çağrıları dinleyen ve böyle bir çağrı tespit edilirse kapatan özellik. Olası değerler 1 veya 0, varsayılan değer 0 |
| SID | Sub Account ID (alt hesap kimliği) – alt hesaplarınızı SubAccounts sekmesinde https://www.multitel.net/auth/setting/ adresinde tanımlayın |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... vb.
Lütfen GET için kullanılan parametrelerin POST için kullanılan parametrelerle tamamen aynı olduğunu ve listelendikleri sıranın aynen korunarak kullanılması gerektiğini unutmayın
yukarıdaki tablo.
Parametrelerin yerlerini karıştırma riskini en aza indirdiği için GET yerine POST kullanmanızı şiddetle öneririz.