兼容的API

API是您的软件和我们的激活服务器之间的互动协议。在你的一边，需要API来实现SMS的自动接收。要使用API，您必须使用您的API密钥，您可以通过简单的注册程序，在您的个人资料部分得到它。我们的API与竞争对手的网站完全兼容。

API协议描述

所有请求必须进入https://api.sms-man.com/stubs/handler_api.php POST 或 GET 请求。所有请求必须包含参数api_key形式的API密钥。所有答案均为json格式

查询余额请求

参数

参数	类型	需要	值
`action`	String	是	`getBalance`
`api_key`	String	是	您的API密钥

结果

ACCESS_BALANCE:$balance (其中$balance是您的账户余额)

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥

取得当前价格

参数

参数	类型	需要	值
`action`	String	是	`getPrices`
`api_key`	String	是	您的API密钥
`country`	Number	否
`service`	String	否

结果

{
  "0": {"vk":{"cost":"15","count":6455},"wb":{"cost":"50","count":124}},
  "1": {"fb":{"cost":"6","count":1000}}
}

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥

获取号码

参数

参数	类型	需要	值
`action`	String	是	`getNumber`
`api_key`	String	是	您的API密钥
`country`	Number	是
`service`	String	是
`maxPrice`	Number	否	您期望的价格
`currency`	String	否	`RUB/USD/EUR`
`ref`	String	否	传递推荐ID

结果

ACCESS_NUMBER:$id:$number
$id - 激活ID
$number - 电话号码

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥
`NO_NUMBERS`	没有号码，稍后再试
`NO_BALANCE`	低余额

获取激活状态

参数

参数	类型	需要	值
`action`	String	是	`getStatus`
`api_key`	String	是	您的API密钥
`id`	Number	是	激活ID

结果

STATUS_WAIT_CODE - 待处理的SMS
STATUS_WAIT_RETRY:$lastcode - 等待代码完善（其中$lastcode - 最后一个，失败的代码）
STATUS_WAIT_RESEND — 等待重发SMS（软件应按重发SMS，并执行改变状态为6）。
STATUS_CANCEL — 激活被取消了
STATUS_OK:$code — 收到代码（其中$code是激活代码）

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥
`NO_ACTIVATION`	没有激活

获取激活状态 V2

参数

参数	类型	需要	值
`action`	String	是	`getStatusV2`
`api_key`	String	是	您的API密钥
`id`	Number	是	激活ID

结果

{
  "verificationType": 0,
  "sms": {"dateTime":"0000-00-00 00:00:00","code":"code","text":"sms text"}
}

STATUS_CANCEL

STATUS_WAIT_CODE

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥
`NO_ACTIVATION`	没有激活

改变激活的状态

参数

参数	类型	需要	值
`action`	String	是	`setStatus`
`api_key`	String	是	您的API密钥
`id`	Number	是	激活ID
`status`	Number	是	激活状态

可用状态

-1 — 取消激活
1 — 通知已发送SMS（可选）。
3 — 申请另一个代码
6 — 完成激活（如果状态是 "收到代码"-标记成功并完成，如果状态是 "准备"-删除并标记错误，如果状态是 "等待重复"-将激活转化为等待SMS）。
8 — 通知该号码已被使用并取消激活。

结果

ACCESS_READY - 号码已确认
ACCESS_RETRY_GET - 等待新的SMS
ACCESS_ACTIVATION - 服务被成功激活
ACCESS_CANCEL - 激活被取消
EARLY_CANCEL_DENIED - 不允许在前2分钟内取消号码。

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥
`NO_ACTIVATION`	激活ID不存在
`BAD_STATUS`	不正确的状态

获取所有国家的列表

参数

参数	类型	需要	值
`action`	String	是	`getCountries`
`api_key`	String	是	您的API密钥

结果

[
  {"id":0,"name":"Россия","name_en":"Russia"},
  {"id":3,"name":"Китай","name_en":"China"}
]

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥

获取所有服务的列表

参数

参数	类型	需要	值
`action`	String	是	`getServices`
`api_key`	String	是	您的API密钥

结果

[
  {"id":"vk","name":"Вконтакте"},
  {"id":"wb","name":"WeChat"},
  {"id":"tg","name":"Telegram"}
]

可能的错误

错误	描述
`BAD_KEY`	不正确的API密钥
`BAD_ACTION`	错误操作