折叠内容

API —  这是您的软件和我们的激活服务器之间的交互协议。 需要API来自动化接收SMS消息的过程

我们的API与sms-activate API兼容

所有请求都必须具有api_key参数形式的API密钥

image
API 激活
API:申请号码

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&maxPrice=$maxPrice&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds

&action=getNumber
$api_key 您的 API密钥(查看个人账户里面的设置部分)
$service :项目代码。查看项目代码部分
$country :国家代码。查看国家代码部分
$maxPrice:您准备购买号码的最高价格
$providerIds - 将进行采购的供应商列表,用逗号分隔 (1,2,3)
$exceptProviderIds - 从号码购买中排除的供应商列表,用逗号分隔 (1,2,3)

常见错误:
BAD_KEY :API密钥不正确;
NO_NUMBERS :没号; 号码没发放成功:再试申请或者更换国家;
The service is prohibited for sale by administration:请选择其他服务;
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。

返回成功结果示例:

ACCESS_NUMBER:38496653:66846426435

其中,38496653是激活编号,66846426435是电话号码。

API 激活
API:申请号码 v2
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumberV2&service=$service&country=$country&maxPrice=maxPrice&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds

&action=getNumberV2

该方法与 getNumber 方法类似,接受相同的参数,但会返回额外的激活信息。

$api_key — 您的 API密钥(查看个人账户里面的设置部分)
$service — 项目代码。查看项目代码部分
$country — 国家代码。查看国家代码部分
$maxPrice — 您准备购买号码的最高价格
$providerIds - 将进行采购的供应商列表,用逗号分隔 (1,2,3)
$exceptProviderIds - 从号码购买中排除的供应商列表,用逗号分隔 (1,2,3)

常见错误:
BAD_KEY — API密钥不正确;
NO_NUMBERS — 没号; 号码没发放成功:再试申请或者更换国家;
The service is prohibited for sale by administration — 请选择其他服务;
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。

返回成功结果示例:

{
   "activationId": 38496653,
   "phoneNumber": "66846426435",
   "activationCost": 12.34,
   "currency": 840,
   "countryCode": "2",
   "canGetAnotherSms": "1",
   "activationTime": "2025-12-31 23:30:55"
}

其中,38496653 为激活 ID,66846426435 为电话号码,  
12.34 为购买价格,  
870 为 ISO 4217 货币代码,  
2 为国家代码,  
0/1 表示是否支持第二条短信(false/true),  
2025-12-31 23:30:55 为激活开始时间。

現在測試這個方法
Your API key
Service code
Country code
API 激活
API:激活状态变更

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

&action=setStatus
$api_key :您的 API密钥(查看个人账户里面的设置部分);
$id :项目id;
$status:接码动态:
-1 :取消接码;
1 :告知电话号可用性 (已发送短信到电话号);
6 :完成接码;
8 :取消接码。

系统应答:
ACCESS_READY :已确认电话可用性;
ACCESS_RETRY_GET :等待着新短信;
ACCESS_ACTIVATION:项目接码成功;
ACCESS_CANCEL 已取消接码

常见错误:
ERROR_SQL :SQL服务器错误;
NO_ACTIVATION :项目ID不存在;
BAD_SERVICE :服务名称不正确;
BAD_STATUS :动态不正确;
BAD_KEY :API密钥不正确;
BAD_ACTION:操作不正确;
&action=getStatus
$api_key
:您的API密钥(查看个人账户里面的设置部分)
$id — 接码 id


系统应答:
STATUS_WAIT_CODE :在等待短信
STATUS_WAIT_RETRY:$lastcode :等待着代码确认( $lastcode :前一个不合适的代码)
STATUS_WAIT_RESEND : 等待着短信重发(软件应该点击重新发送短信,并且把动态更改成6)
STATUS_CANCEL : 接码被取消了
STATUS_OK:$code :收到了验证码( $code 是验证码)

SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。

API 激活
API:获取激活状态

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

&action=getStatus
$api_key :您的 API密钥(查看个人账户里面的设置部分)
$id :项目id

系统应答:
STATUS_WAIT_CODE :在等待短信
STATUS_WAIT_RETRY:$lastcode : 等待着代码确认( $lastcode :前一个不合适的代码)
STATUS_WAIT_RESEND : 等待着短信重发(软件应该点击重新发送短信,并且把动态更改成6)
STATUS_CANCEL : 接码被取消了
STATUS_OK:$code :收到了验证码( $code 是验证码)


常见错误:
NO_ACTIVATION :项目 id 不存在
BAD_KEY :API密钥不正确
BAD_ACTION :操作不正确
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。

API 激活
API:余额查询

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

&action=getBalance
$api_key :您的 API密钥(查看个人账户里面的设置部分)。

系统应答:
ACCESS_BALANCE:$balance

可能出现的错误:
BAD_KEY — API密钥不正确
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。

API 激活
API:按国家获取当前价格

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

&action=getPrices
$api_key :您的 API密钥(查看个人账户里面的设置部分);
$service:项目代码。查看项目代码部分;
$country :国家代码。查看国家代码部分。

可能出现的错误:
BAD_KEY — API密钥不正确
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。

系统应答

 

{
  "国家": {
    "服务项目": {
      "cost": 价格,
      "count": 数量
    }
  }
}

 

API 激活
API:获取当前价格 v2
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPricesV2&service=$service&country=$country

&action=getPricesV2
$api_key
— 您的 API密钥(查看个人账户里面的设置部分)
$service — 项目代码。查看项目代码部分
$country — 国家代码。查看国家代码部分

常见错误:
BAD_KEY — API密钥不正确
BAD_ACTION — 操作不正确
BAD_SERVICE — 服务名称不正确

系统应答: 

  "country": {
    "service": {
            "price1": count,
            "price2": count,
            "price3": count,
          }
     },
現在測試這個方法
Your API key
Service code
Country code
API 激活
API:获取当前价格 v3
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPricesV3&service=$service&country=$country

&action=getPricesV3
$api_key
— 您的 API密钥(查看个人账户里面的设置部分)
$service — 项目代码。查看项目代码部分
$country — 国家代码。查看国家代码部分。

可能出现的错误:
BAD_KEY — Invalid API key
BAD_ACTION — incorrect action
BAD_SERVICE — incorrect service name

系统应答

{
  "country": {
    "service": {
      "price": price,
      "count": count,
      "providers": {
        "provider 1 id": {
          "count": count,
          "price": [price1, price2],
          "provider_id": provider_id
        },
        "provider 2 id": {
          "count": count,
          "price": [price],
          "provider_id": provider_id
        },
        "provider 3 id": {
          "count": count,
          "price": [price1, price2, price3],
          "provider_id": provider_id
        }
      }
    }
  }
}
現在測試這個方法
Your API key
Service code
Country code
工具 API
工具 API: 获取用于支付的静态钱包
https://api.grizzlysms.com/public/crypto/wallet?api_key=$api_key&coin=usdt&network=tron

$api_key – 您的API密钥 (可在“设置”中找到);
$coin – 币种(支持:usdt);
$network – 区块链网络(支持:trc-20)

返回示例:

  {
        "wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
    }

現在測試這個方法
Your API-key