折叠内容

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

我们的API与sms-activate API兼容

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

API激活
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是电话号码。

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 是验证码)

常见错误:
NO_ACTIVATION :项目 id 不存在
BAD_KEY :API密钥不正确
BAD_ACTION :操作不正确

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 :操作不正确

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密钥不正确

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 :国家代码。如果不填写,系统默认定位俄罗斯代码。 查看国家代码部分。

系统应答

 

{
  "国家": {
    "服务项目": {
      "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 – 服务器错误,稍后重复请求.

空气污染指数租金
Rest API:获取激活状态

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 – 服务器错误,稍后重复请求.

空气污染指数租金
租金API:按国家/地区获取当前价格

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 – 服务器错误,稍后重复请求.