この機能では電話番号を購入できます。
簡単に設定するには、デフォルトのringto URI（着信先URI）を定義し（"URI Settings" — URI設定 — タブのhttps://www.multitel.net/auth/setting）、以下の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 | Webインターフェースの「Forward Destination」に相当します。設定可能な値は、1（SIPの場合）または2（Dialの場合）です |
| RingType | 順次呼び出し（Sequential）は1、ランダム（Random）は2、同時呼び出し（Simultaneous）は3 |
| Ringstyle | 1 は呼出音、2 は音楽（Early Media） |
| URI | 最初に呼び出すSIP URI（またはダイヤルする電話番号。00/011/+の接頭辞は付けないでください） |
| URI2 | 2 番目に呼び出す SIP URI |
| URI3 | 3 番目に呼び出す SIP URI |
| SMSRingType | メール送信は1、URLへのPOST送信は2 |
| SMSURI | Eメールアドレス、またはPOST URLのいずれか |
| FaxDetect | 有効は1、無効は0です。指定しない場合、デフォルトは0です |
| FaxEmail | FAXの転送先メールアドレス |
| FaxRing | FAXトーンを何秒間リッスンすべきですか？デフォルトは5です |
| Vm | ボイスメールは有効ですか？ 可能な値は1または0 |
| Vmring | ボイスメールが作動するまでの秒数 |
| Vms2t | ボイスメールの音声テキスト変換（Speech 2 Text）-- 有効の場合は1、無効の場合は0 |
| Vmemail | ボイスメールの転送先メールアドレス |
| Cnam | CNAMルックアップを有効にする(指定可能な値は0または1 - デフォルトは0) |
| Record | 通話を録音する（0または1、デフォルトは0） |
| Screening | 発信者のスクリーニング（接続前に名乗るよう求めます - 設定可能な値は0または1、デフォルトは0） |
| Channels | 必要なチャンネル数はいくつですか?利用可能なチャンネルが1つしかない番号でない限り、デフォルトは2です。なお、SMS専用番号(VoIP機能のない番号)では、この設定は効果がないため、不要な場合は設定しないでください。 |
| Atcd | 自動テレマーケティング通話検出 -- 自動音声/ロボット通話を検知し、検出された場合に通話を切断する機能。設定可能な値は1または0で、デフォルトは0です |
| SID | サブアカウントID -- サブアカウントは https://www.multitel.net/auth/setting/ の サブアカウント (SubAccounts) タブで定義します |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... など
GETに使用されるパラメーターは、POSTに使用されるパラメーターとまったく同じであり、記載されている順序どおりに使用する必要があることにご注意ください
上記の表。
パラメーターの取り違えのリスクを最小限に抑えられるため、GET ではなく POST の使用を強くお勧めします。