此功能允许您购买电话号码。
要简化设置,只需定义默认的 ringto URI(呼叫目标 URI;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未成功的呼叫将返回以下消息之一:
{"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 表示振铃,2 表示音乐(Early Media) |
| 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 | 语音信箱语音转文字(Voicemail 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——在 子账户 (SubAccounts) 选项卡中的 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 所用的参数完全相同,并且应按照其中所列的确切顺序使用
上表。
我们强烈建议使用 POST 而不是 GET,因为这样可以最大程度降低参数错位的风险。