Fungsi ini memungkinkan Anda membeli nomor telepon.
Agar lebih sederhana, tetapkan ringto URI bawaan, yaitu URI tujuan panggilan (https://www.multitel.net/auth/setting, di tab "URI Settings" — pengaturan URI), lalu panggil URL di bawah ini:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Pemanggilan API yang berhasil akan mengembalikan pesan berikut:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Panggilan yang tidak berhasil akan menghasilkan salah satu pesan berikut:
{"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.Jika Anda perlu menentukan lebih banyak parameter, baca terus:
POST URL: https://api.multitel.net/json/buynumbers/
Parameter POST:
| UserName | Nama Pengguna login Anda atau Nama Pengguna API Anda |
| Password | Kata sandi login Anda atau Kata Sandi API Anda |
| Number | Nomor telepon yang ingin Anda beli |
| Description | Deskripsi singkat (jika tidak diberikan, default ke Number) |
| Type | Setara dengan “Forward Destination” pada antarmuka web. Nilai yang mungkin: 1 (untuk SIP) atau 2 (untuk Dial) |
| RingType | 1 untuk berurutan, 2 untuk acak, 3 untuk serentak |
| Ringstyle | 1 untuk Ring, 2 untuk Musik (Early Media) |
| URI | SIP URI pertama yang akan berdering (atau nomor telepon yang akan dihubungi -- harap tanpa awalan 00/011/+) |
| URI2 | SIP URI kedua untuk berdering |
| URI3 | URI SIP ketiga yang akan dibunyikan |
| SMSRingType | 1 untuk email, 2 untuk pengiriman permintaan POST ke URL |
| SMSURI | alamat email atau URL untuk pengiriman melalui HTTP POST |
| FaxDetect | 1 untuk aktif, 0 untuk nonaktif. Jika tidak ditentukan, nilai defaultnya adalah 0 |
| FaxEmail | Email tujuan penerusan faks |
| FaxRing | Berapa detik kita harus mendengarkan nada faks? Defaultnya 5 |
| Vm | Pesan suara diaktifkan? Nilai yang dimungkinkan 1 atau 0 |
| Vmring | Berapa detik sebelum VM aktif |
| Vms2t | Konversi pesan suara menjadi teks (Voicemail Speech 2 Text) -- 1 untuk aktif, 0 untuk nonaktif |
| Vmemail | Alamat email tujuan penerusan pesan suara |
| Cnam | Aktifkan pencarian CNAM (nilai yang mungkin 0 atau 1 - bawaan 0) |
| Record | Rekam percakapan telepon (0 atau 1 , defaultnya 0) |
| Screening | Minta penelepon menyebutkan identitas sebelum dihubungkan (nilai yang mungkin adalah 0 atau 1, nilai bawaan 0). |
| Channels | Berapa banyak kanal yang kita perlukan? Default-nya 2 kecuali nomor hanya memiliki 1 kanal yang tersedia. Perlu diketahui bahwa untuk nomor khusus SMS (nomor yang tidak memiliki kemampuan VoIP), pengaturan ini tidak berpengaruh, jadi jangan mengaturnya jika Anda tidak membutuhkannya. |
| Atcd | Deteksi Otomatis Panggilan Telemarketer -- fitur yang mendengarkan panggilan otomatis/robo dan menutup telepon jika panggilan semacam itu terdeteksi. Nilai yang mungkin 1 atau 0, default 0 |
| SID | ID Sub Akun -- tentukan subakun Anda di https://www.multitel.net/auth/setting/ pada tab Subakun (SubAccounts) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... dan seterusnya
Harap perhatikan bahwa parameter yang digunakan untuk GET sama persis dengan parameter yang digunakan untuk POST dan harus digunakan dalam urutan yang persis seperti urutan pencantumannya dalam
tabel di atas.
Kami sangat menyarankan Anda menggunakan POST daripada GET karena meminimalkan risiko tertukarnya parameter.