
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是电话号码。
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
}
}
}
}
}
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&country=$country&rent_time=$time
$api_key – 您的API密钥(设置);
$service – 服务代码;
$country – 国家代码;
$time – 租赁时间(分钟) (4小时).
服务响应将采用json格式:
{
"status": "status",
"phone": {
"id": "id rent",
"endDate": "rent expiration date",
"number":"phone number"
}
}
成功答案的例子:
{
"status": "success",
"phone": {
"id": "38496653",
"endDate": "2023-12-31T19:30:52",
"number": "66846426435"
}
}
有错误的答案示例:
{
"status": "error",
"error": "BAD_KEY"
}
可能的错误:
BAD_KEY – 检查您的API密钥;
BAD_COUNTRY – 检查国家代码;
BAD_SERVICE – 检查服务代码;
INVALID_TIME – 检查计数小时;
NO_BALANCE – 账户资金不足;
NO_NUMBERS – 重复请求或选择其他国家/地区;
SERVER_ERROR – 服务器错误,稍后重复请求;
The service is prohibited for sale by administration:请选择其他服务;
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time
$api_key – 您的API密钥(设置);
$time - 租赁时间(分钟) (4小时).
服务响应将采用json格式:
{
"status": "status",
"phone": {
"id": "id rent",
"endDate": "rent expiration date",
"number": "phone number"
}
}
成功答案的例子:
{
"status": "success",
"phone": {
"id": "38496653",
"endDate": "2023-12-31T19:30:52",
"number": "66846426435"
}
}
有错误的答案示例:
{
"status": "error",
"error":"BAD_KEY"
}
可能的错误:
BAD_KEY – 检查您的API密钥;
INVALID_TIME – 检查计数小时;
NO_ID_RENT – 检查身份证租金;
NO_BALANCE – 账户资金不足;
RENT_DIE – 此号码不再可用,请选择一个新号码;
SERVER_ERROR – 服务器错误,稍后重复请求.
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentHistory&id=$id
$api_key – 您的API密钥(设置);
$id – 身份证租金;
服务响应将采用json格式:
{
"status": "status",
"quantity": "number of times rented",
"values": {
"1": {
"date": "rent commencement date",
"price": rentalCost,
"hours":rentDuration
}
}
成功答案的例子:
{
"status": "success",
"quantity": "2",
"values": {
"1": {
"date": "2023-10-26 11:03:39",
"price": 3.6,
"hours": 4
},
"2": {
"date":"2023-10-25 11:02:31",
"price": 4,
"hours": 5
}
}
}
一个空号成功响应的例子:
{
"status": "success",
"values": {}
}
有错误的答案示例:
{
"status": "error",
"error": "SQL_ERROR"
}
可能的错误:
BAD_KEY – 检查您的API密钥;
NO_ID_RENT – 检查身份证租金;
SQL_ERROR – SQL server错误,稍后重复请求.
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status
$api_key – 您的API密钥(设置);
$id – 身份证租金;
$status – 租金状况:
1 – 完成租金;
2 – 取消租金.
服务响应将采用json格式:
{
"status": "статус"
}
成功答案的例子:
{
"status": "success"
}
有错误的答案示例:
{
"status": "error",
"error": "CANT_CANCEL"
}
可能的错误:
BAD_KEY – 检查您的API密钥;
NO_ID_RENT – 检查身份证租金;
INVALID_PHONE – id租金不存在;
INCORECT_STATUS – 查看租金状况;
ALREADY_FINISH – 租金已经敲定;
ALREADY_CANCEL – 租金已被取消;
CANT_CANCEL – 无法取消(收到短讯或已过20分钟);
SQL_ERROR – SQL 服务器错误,稍后重复请求;
SERVER_ERROR – 服务器错误,稍后重复请求;
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id
$api_key – 您的API密钥(设置);
$id – 身份证租金.
服务响应将采用json格式:
{
"status": "status",
"quantity": "number of codes",
"values": {
"0": {
"phoneFrom": "phone number",
"service": "service code",
"text": "sms code",
"date": "date of SMS receipt"
}
}
}
成功答案的例子:
{
"status": "success",
"quantity": "2",
"values": {
"0 ": {
"phoneFrom": "66846426435",
"service": "tg",
"test": "123456",
"date": "2023-10-26 11:03:39"
},
"1": {
"phoneFrom ": "66846426435",
"service": "tg",
"test": "224444",
"date": "2023-10-26 11:02:31"
}
}
}
使用空代码列表的成功响应示例:
{
"status": "success",
"values":{}
}
有错误的答案示例:
{
"status": "error",
"error": "NO_ID_RENT"
}
可能的错误:
BAD_KEY – 检查您的API密钥;
NO_ID_RENT – 检查身份证租金;
INVALID_PHONE – id租金不存在;
SERVER_ERROR – 服务器错误,稍后重复请求;
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentPrices&service=$service&country=$country&rent_time=$time
$api_key – 您的API密钥(设置);
$service – 服务代码;
$country – 国家代码;
$time - 租赁时间(分钟) (4小时).
服务响应将采用json格式:
{
"status": "status",
"values": {
"Country": {
"Service": {
"cost": cost,
"count": number,
"max_hours": maximumRentalHours
}
}
}
}
成功答案的例子:
{
"status": "success",
"values": {
"0": {
"tg": {
"cost": 12,
"max_hours": 10,
"count": 15
}
}
}
}
有错误的答案示例:
{
"status": "error",
"error": "INVALID_TIME"
}
可能的错误:
BAD_KEY – 检查您的API密钥;
BAD_COUNTRY – 检查国家代码;
BAD_SERVICE – 检查服务代码;
INVALID_TIME – 检查计数小时;
NO_NUMBERS – 重复请求或选择其他国家/地区;
SERVER_ERROR – 服务器错误,稍后重复请求;
SERVICE_UNAVAILABLE_REGION — 您所在地区的访问受限,请使用其他地区的 IP 地址。