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
&action=getNumber
$api_key :您的 API密钥(查看个人账户里面的设置部分)。
$service :项目代码。查看项目代码部分。
$country :国家代码。查看国家代码部分。如果不填写,系统默认定位俄罗斯代码。
常见错误:
BAD_KEY :API密钥不正确;
NO_NUMBERS :没号; 号码没发放成功:再试申请或者更换国家。
返回成功结果示例:
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 是验证码)
常见错误:
NO_ACTIVATION :项目 id 不存在
BAD_KEY :API密钥不正确
BAD_ACTION :操作不正确
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 :操作不正确
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密钥不正确
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 :国家代码。如果不填写,系统默认定位俄罗斯代码。 查看国家代码部分。
系统应答:
{ "国家": { "服务项目": { "cost": 价格, "count": 数量 } } }
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 – 服务器错误,稍后重复请求.
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 – 服务器错误,稍后重复请求.
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错误,稍后重复请求.
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 – 服务器错误,稍后重复请求.
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 – 服务器错误,稍后重复请求.
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 – 服务器错误,稍后重复请求.