API 文档

API 是允许您的软件和我们的激活服务器之间通信的协议.

您这边的 SMS、OTP 和 PVA 接收过程需要 API 来实现自动化。

我们的 API 与竞争对手的网站完全兼容。
所有请求都应为 https://smsbower.online/stubs/handler_api.php
POST 或 GET 请求。

所有请求都必须有一个 API 密钥作为参数“api_key”

预定号码租用

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getBalance

已复制

参数 $api_key - API 密钥

答案
ACCESS_BALANCE:账户余额

可能有错误:
BAD_KEY - api 密钥不正确

答案
ACCESS_BALANCE:$yourBalance

请求号码

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getN
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 - 不正确的服务名称

获取短信代码

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

已复制

参数 $api_key - API 密钥 $id - 激活ID

答案
STATUS_WAIT_CODE - 等待短信 STATUS_WAIT_RESEND - 等待下一条短信 STATUS_CANCEL - 激活被取消 STATUS_OK: 'activation code' - 收到代码

可能有错误:
BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 NO_ACTIVATION - id 激活没存在

激活状态的修改

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=setSt
atus&status=$status&id=$id

已复制

参数 $api_key - API 密钥 $id - 激活ID $status - 激活状态

1 - 通知号码准备就绪（短信发送到号码） 3 - 请求另一个代码（免费） 6 - 完整激活 * 8 - 通知号码已被使用并取消激活

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_SERVICE - 不正确的服务名称 BAD_STATUS - 不正确的状态 BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 EARLY_CANCEL_DENIED - 购买后2分钟内可以取消号码

收到各国家现实的价格

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
rices&service=$service&country=$country

已复制

参数 $api_key - API 密钥 $service - 服务的简称（不一定，所有的服务预设）见表 $country - 密码国家名称（不一定，所有的国家预设见表

答案
JSON - 对象格式

{''国家'':
        {''服务'':
            {
                ''cost'':成本,'
                'count'':计数
            }
        }
}

服务列表

国家列表

请求号码V2

该方法的工作方式与该方法类似getNumber采用相同的参数，但返回其他激活信息.

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getN
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 - 不正确的服务名称

获取完整价格表 v2

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
ricesV2&service=$service&country=$country

已复制

参数 api_key - API 密钥 $service - 服务见表 $country - 国家号码见表

答案示例


            "国家": {
    "服务": {
            "价格1": 数数,
            "价格2": 数数,
            "价格3": 数数,
          }
     },

已复制

可能有错误: BAD_KEY - api 密钥不正确 BAD_ACTION - 错误的动作 BAD_SERVICE - 不正确的服务名称

获取完整价格表 v3

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
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 - 不正确的服务名称