
API — 这是您的软件和我们的激活服务器之间的交互协议。 需要API来自动化接收SMS消息的过程
我们的API与sms-activate API兼容
所有请求都必须具有api_key参数形式的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是电话号码。
&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 为激活开始时间。
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 地址。
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 地址。
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 地址。
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": 数量
}
}
}
&action=getPricesV2
$api_key — 您的 API密钥(查看个人账户里面的设置部分)
$service — 项目代码。查看项目代码部分
$country — 国家代码。查看国家代码部分
常见错误:
BAD_KEY — API密钥不正确
BAD_ACTION — 操作不正确
BAD_SERVICE — 服务名称不正确
系统应答:
"country": {
"service": {
"price1": count,
"price2": count,
"price3": count,
}
},
&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
}
}
}
}
}
$api_key – 您的API密钥 (可在“设置”中找到);
$coin – 币种(支持:usdt);
$network – 区块链网络(支持:trc-20)
返回示例:
{
"wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
}