BuyNumbers REST 函数 — 购买电话号码

此功能允许您购买电话号码。


要简化设置,只需定义默认的 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,因为这样可以最大程度降低参数错位的风险。

搜索文档