API 文档
API 是允许您的软件和我们的激活服务器之间通信的协议 .
您这边的 SMS、OTP 和 PVA 接收过程需要 API 来实现自动化。
我们的 API 与竞争对手的网站完全兼容。
所有请求都应为 https://smsbower.online/stubs/handler_api.php
POST 或 GET 请求。
所有请求都必须有一个 API 密钥作为参数“api_key”
参数 $api_key - API 密钥
答案
ACCESS_BALANCE:账户余额
可能有错误:
BAD_KEY - api 密钥不正确
答案
ACCESS_BALANCE:$yourBalance
umber&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds$exceptProviderIds
&phoneException$phoneException&ref$ref
参数 $api_key - API 密钥 $service - 订购服务 见表 $country - 国家号码 见表 $maxPrice - 您准备购买号码的最高价格 $providerIds - 将进行采购的供应商列表,用逗号分隔 (1,2,3) $exceptProviderIds - 从号码购买中排除的供应商列表,用逗号分隔 (1,2,3) $phoneException - 不包括数字前缀。以逗号分隔。记录格式:国家代码和 3 到 6 位掩码(例如 7918,7900111) $ref - 转移推荐 ID 通过API获取号码即表示您同意项目规则 项目规则
答案 ACCESS_NUMBER:$activationId:$phoneNumber
可能有错误: BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 BAD_SERVICE - 不正确的服务名称
参数 $api_key - API 密钥 $id - 激活ID
答案
STATUS_WAIT_CODE - 等待短信
STATUS_WAIT_RETRY:$lastCode - 等待下一条短信
STATUS_CANCEL - 激活被取消
STATUS_OK: 'activation code' - 收到代码
可能有错误:
BAD_KEY - api 密钥不正确
BAD_ACTION - 错误的动作
NO_ACTIVATION - id 激活没存在
atus&status=$status&id=$id
API年表的简单逻辑:
使用 getNumber 方法获取号码,然后可以进行以下行为: 8 - 取消激活(如果该号码不适合您) 1 - 报告已发送短信(可选)
要以状态1激活: 8 - 取消激活
收到代码后立即: 3 - 请求另一个短信 6 - 确认短信代码并完成激活
要以状态3激活: 6 - 确认短信代码并完成激活
答案 ACCESS_READY - phone is ready for getting SMS ACCESS_RETRY_GET - 期待新短信 ACCESS_ACTIVATION - 服务成功激活 ACCESS_CANCEL - 激活取消
可能有错误:
NO_ACTIVATION - id 激活没存在
BAD_STATUS - 不正确的状态
BAD_KEY - api 密钥不正确
BAD_ACTION - 错误的动作
EARLY_CANCEL_DENIED - 购买后2分钟内可以取消号码
参数 $api_key - API 密钥
答案
JSON - 对象格式
{
"status": "success",
"services": [
{
"code": "kt",
"name": "KakaoTalk"
}
]
}
参数 $api_key - API 密钥
答案
JSON - 对象格式
{
{
"id": 1003
"rus": "Бермуды"
"eng": "Bermuda"
"chn": "百慕大"
}
}
该方法的工作方式与该方法类似getNumber采用相同的参数,但返回其他激活信息 .
umberV2&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
参数 api_key - API 密钥 $service - 订购服务 见表 $country - 国家号码 见表 $maxPrice - 您准备购买号码的最高价格 $providerIds - 将进行采购的供应商列表,用逗号分隔 (1,2,3) $exceptProviderIds - 从号码购买中排除的供应商列表,用逗号分隔 (1,2,3) 通过API获取号码即表示您同意项目规则 项目规则
如果请求成功,响应将采用以下格式: .
{
"activationId": "id",
"phoneNumber": number,
"activationCost": activationCost,
"countryCode": countryCode,
"canGetAnotherSms": canGetAnotherSms,
"activationTime": activationTime,
"activationOperator": activationOperator,
}
可能有错误: BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 BAD_SERVICE - 不正确的服务名称
ricesV2&service=$service&country=$country
参数 api_key - API 密钥 $service - 服务 见表 $country - 国家号码 见表
"国家": {
"服务": {
"价格1": 数数,
"价格2": 数数,
"价格3": 数数,
}
},
可能有错误: BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 BAD_SERVICE - 不正确的服务名称
ricesV3&service=$service&country=$country
参数 api_key - API 密钥 $service - 服务 见表 $country - 国家号码 见表
"国家": {
"服务": {
"provider 1 id": {
count: 数数,
price: 价格,
provider_id: provider id,
},
"provider 2 id": {
count: 数数,
price: 价格,
provider_id: provider id,
},
"provider 3 id": {
count: 数数,
price: 价格,
provider_id: provider id,
},
}
},
可能有错误: BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 BAD_SERVICE - 不正确的服务名称 BAD_COUNTRY - 不正确的服务名称
&network=$network
参数 api_key - API 密钥 $coin - coin (usdt, trx) $network - network number (tron)
{
"wallet_address": "TFGMAwTfxtxKvy1mTTHr7XJaXeumjdmhGg"
}
Webhook 是一种自动通知系统有关事件的机制。 获取号码后,无需不断轮询服务器以获取传入的 SMS 消息。 我们可以立即将它们的内容发送到您在设置中指定的地址(或多个地址)。
Webhook 请求的 IP 地址
为确保通知的正确运行并避免丢失,请将以下 IP 地址添加到服务器上允许来源的白名单中:
激活和租用的 Webhook 将来自以下地址:
确保您的服务器接受来自这些 IP 的传入请求。
传入的 SMS 通知
如果您的个人资料中指定了 Webhook URL https://your-site.com/webhook.php, 当收到 SMS 消息时,我们将以以下格式向该地址发出 POST 请求:
{
"activationId": 123456,
"service": "go",
"text": "Sms text",
"code": "12345",
"country": 2,
"receivedAt": "2023-01-01 12:00:00"
}
服务器响应
您的脚本必须返回 HTTP 状态 200。
- - 如果服务器没有响应,将会在 1 分钟后和 5 分钟后进行 2 次重试请求。
- - 如果尝试 3 次不成功,您将收到通知,并在您的 profile 中看到错误。
您可以在您的 profile settings 中启用或禁用 Webhook。