兼容的API
API是您的软件和我们的激活服务器之间的互动协议。在你的一边，需要API来实现sms短信的自动接收。要使用API，您必须使用您的API密钥，您可以通过简单的注册程序，在您的个人资料部分得到它。我们的API与竞争对手的网站完全兼容。
API端口描述
所有请求必须进入https://api.sms-man.com/stubs/handler_api.php POST 或 GET 请求。所有请求必须包含参数api_key形式的API密钥。所有答案均为json格式
查询余额请求
https://api.sms-man.com/stubs/handler_api.php?action=getBalance&api_key=$api_key
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getBalance |
| api_key | 线路 | 是 | 您的API密钥 |
结果
ACCESS_BALANCE:$balance (其中$balance是您的账户余额)
可能的错误
取得當前價格
https://api.sms-man.com/stubs/handler_api.php?action=getPrices&api_key=$api_key&country=$country&service=$service
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getPrices |
| api_key | 线路 | 是 | 您的API密钥 |
| country | 帐号 | 不可以 | 国家号码 |
| service | 线路 | 不可以 | 号码服务 |
结果
{"0":{"vk":{"cost":"15","count":6455},"wb":{"cost":"50","count":124}}
"1":{"fb":{"cost":"6","count":1000}}
可能的错误
获取号码
https://api.sms-man.com/stubs/handler_api.php?action=getNumber&api_key=$api_key&service=$service&country=$country&ref=$ref
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getNumber |
| api_key | 线路 | 是 | 您的API密钥 |
| country | 帐号 | 是 | 国家号码 |
| service | 线路 | 是 | 号码服务 |
| maxPrice | 帐号 | 不可以 | 您期望的价格 |
| currency | 线路 | 不可以 | RUB/USD/EUR |
| ref | 线路 | 不可以 | 转移返利ID |
结果
ACCESS_NUMBER:$id:$number
$id - 激活ID
$number - 电话号码
可能的错误
| 错误 | 描述 |
|---|
| BAD_KEY | 不正确的API密钥 |
| NO_NUMBERS | 没有号码，稍后再试 |
| NO_BALANCE | 低余额 |
获取激活状态
https://api.sms-man.com/stubs/handler_api.php?action=getStatus&api_key=$api_key&id=$id
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getNumber |
| api_key | 线路 | 是 | 您的API密钥 |
| id | 帐号 | 是 | 激活ID |
结果
STATUS_WAIT_CODE - 待处理的短信
STATUS_WAIT_RETRY:$lastcode - 等待代码完善（其中--最后一个，失败的代码）
STATUS_WAIT_RESEND — 等待重发短信（软件应按重发短信，并执行改变状态为6）。
STATUS_CANCEL — 激活被取消了
STATUS_OK:$code — 收到代码（其中$code是激活代码）
可能的错误
| 错误 | 描述 |
|---|
| BAD_KEY | 不正确的API密钥 |
| NO_ACTIVATION | 没有激活 |
获取激活状态 V2
https://api.sms-man.com/stubs/handler_api.php?api_key=$api_key&action=getStatusV2&id=$id
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getStatusV2 |
| api_key | 线路 | 是 | 您的API密钥 |
| id | 帐号 | 是 | 激活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 | 没有激活 |
改变激活的状态
https://api.sms-man.com/stubs/handler_api.php?action=setStatus&api_key=$api_key&id=$id&status=$status
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | setStatus |
| api_key | 线路 | 是 | 您的API密钥 |
| id | 帐号 | 是 | 激活ID |
| status | 帐号 | 是 | 激活状态 |
可用状态
-1 — 取消激活
1 — 通知已发送短信（可选）。
3 — 申请另一个代码
6 — 完成激活（如果状态是 "收到代码"-标记成功并完成，如果状态是 "准备"-删除并标记错误，如果状态是 "等待重复"-将激活转化为等待短信）。
8 — 通知该号码已被使用并取消激活。
结果
ACCESS_READY - 号码已确认
ACCESS_RETRY_GET - 等待新的短信
ACCESS_ACTIVATION - 服务被成功激活
ACCESS_CANCEL - 激活被取消
EARLY_CANCEL_DENIED - 不允许在前2分钟内取消号码。
可能的错误
| 错误 | 描述 |
|---|
| BAD_KEY | 不正确的API密钥 |
| NO_ACTIVATION | 激活ID不存在 |
| BAD_STATUS | 没有激活 |
获取所有国家的列表
https://api.sms-man.com/stubs/handler_api.php?action=getCountries&api_key=$api_key
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getCountries |
| api_key | 线路 | 是 | 您的API密钥 |
结果
[{'id':0,'name':"Россия","name_en:"Russia"},
{'id':3,'name':"Китай","name_en:"China"}]
可能的错误
获取所有服务的列表
https://api.sms-man.com/stubs/handler_api.php?action=getServices&api_key=$api_key
参数
| 参数 | 类型 | 需要 | 价值 |
|---|
| action | 线路 | 是 | getServices |
| api_key | 线路 | 是 | 您的API密钥 |
结果
[{'id':'vk','name':"Вконтакте"}, {'id':'wb','name':"WeChat"},
{'id':'tg','name':"Telegram"}]
可能的错误
| 错误 | 描述 |
|---|
| BAD_KEY | 不正确的API密钥 |
| BAD_ACTION | 错误操作 |
