激活 API

订购电话号码

此请求用于获取虚拟号码。您可以设置服务、运营商和国家等参数，以获取后续使用的号码。

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY

输入参数

参数	该参数可接受的值	是否必填	说明
APIKEY	请在账户设置中查看	是	API 密钥用于访问付费服务。
SERVICE	请在左侧菜单中查看服务列表	是	需要获取号码的服务
OPERATOR	请在左侧菜单中查看运营商列表。	否	需要获取号码的移动运营商
COUNTRY	请在左侧菜单中查看国家列表。	是	需要获取号码所属的国家
URL	完整的 webhook URL（http/https）	否	Webhook 接口地址。如果设置，当购买的号码收到短信时，我们会向该 URL 发送 POST 请求并推送短信数据。
MAXPRICE	数字（整数或带小数点的小数）	否	如果购买号码的价格高于该参数，即使有可用号码也将返回 NO_NUMBERS。

服务响应

服务响应	示例	说明
ACCESS_NUMBER:ID:NUMBER	ACCESS_NUMBER:234242:79123456789	成功获取号码，其中 ID 为激活 ID，NUMBER 为包含国家代码的电话号码

此请求用于管理系统中号码的状态。

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID

输入参数

支持的状态值：

3 - 请求重新发送短信

6 - 激活成功完成

8 - 激活已取消，已退款

服务响应

此请求用于获取系统中号码的当前状态。

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID

输入参数

服务响应

该请求用于获取当前可用电话号码数量的信息。

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR

输入参数

服务响应

服务响应	说明
JSON 响应	返回格式：{"Service_0":"Quantity"}

此请求用于获取指定服务和国家的所有可用价格列表，用于获取最新的服务费用信息。

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY

输入参数

服务响应

服务响应	说明
JSON 响应	返回格式：{"Country":{"Price":Quanity}}}

此请求用于获取与指定 API 密钥关联的当前账户余额。

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getBalance

输入参数

参数	该参数可接受的值	是否必填	说明
APIKEY	请在账户设置中查看	是	API 密钥用于访问付费服务。

服务响应

服务响应	示例	说明
ACCESS_BALANCE:BALANCE	ACCESS_BALANCE:540	BALANCE — 您的账户余额