Grizzly SMS 合作伙伴API文档

Description of the protocol's operation

合作伙伴协议旨在通过API直接将电话号码和收到的短信提供给Grizzly SMS服务器。

所有请求均包含参数KEY。该密钥由支持人员提供，并可在个人账户中获取。

获取服务数量的请求 GET_SERVICIOS, 获取号码的请求 GET_NUMBER 以及完成激活的请求 FINISH_ACTIVACIÓN 均由我们的服务器直接发送至合作伙伴服务器。

URL格式：https://GrizzlySMS，其中GrizzlySMS可为 partner.ru:port/GrizzlySMS.php 或 partner.ru/GrizzlySMS.php

GET_SERVICIOS

GET_NUMBER

PUSH_SMS

FINISH_ACTIVACIÓN

SMS Grizzly服务器使用 GET_SERVICIOS 方法每10-20秒左右发送一次电话号码数量的请求。

如果在响应中提供的数量 > 0，您将收到一条使用 GET_NUMBER 方法获取电话号码的请求。

在收到 GET_NUMBER 请求后，您必须提供一个符合所有条件的电话号码，并使用 PUSH_SMS 方法将所有收到的短信重新发送给我们。这是为了使我们能够进行清晰、客观的筛选，并将相关短信准确地传递给相应服务，以满足客户的需求。

在完成与电话号码相关的所有必要任务后，您将通过 FINISH_ACTIVACIÓN 方法收到状态 3。该状态表示电话号码已成功注册，您将因此获得相应奖励。

要求：

请求/响应格式：JSON
编码：UTF-8
向Grizzly SMS服务器发送请求时，请务必使用User-Agent请求头

字段类型：

int：取值范围为 -2,147,483,648 至 2,147,483,647 的整数值
uint：取值范围为 0 至 2,147,483,647 的无符号整数值
long：取值范围为 -9,223,372,036,854,775,808 至 9,223,372,036,854,775,807 的整数值
ulong：取值范围为 0 至 9,223,372,036,854,775,807 的无符号长整型值
cur：最多包含两位小数的实数，例如 177.77
boolean：字面值 true 或 false
string：长度不限的字符串值
string array：字符串数组

1. GET_SERVICES number request method

该请求向我们提供有关可用于销售的服务电话号码数量的信息。

该POST请求由Grizzly SMS服务器发送至合作伙伴服务器。

! 注意：如果您的GSM调制解调器同时激活的模块数量有限，则必须提供的数量等于当前激活的模块数量。

请求字段
字段	类型	是否必填	说明
acción	Cuerda		GET_SERVICIOS
clave	Cuerda		协议密钥

响应字段:
字段	字段	是否必填	说明
estado	Cuerda		响应状态 (参见状态表)
Lista de Paisanos	Matriz de CountryList		国家列表

国家列表
字段	类型	是否必填	说明
país	Cuerda		(参见数据表)
Mapa Operativo*	Asociativo matriz		运营商键值 (ver Tabla de Datos), 关联服务数组**

* 在运营商映射中不得发送空的数据数组

** 服务关联数组：键：服务的简短名称（参见数据表），值：该服务可用的电话号码数量（类型: int)

请求示例：

{
  "action": "GET_SERVICIOS",
  "key": "qwerty123"
}

响应示例：

{
  "countryList":
    [
      {
        "country": "russia",
        "operatorMap":
          {
            "any":
              {
                "vk": 3,
                "ok": 10
              }
          }
      },
      {
        "country": "ukraine",
        "operatorMap":
          {
            "any":
              {
                "vk": 0,
                "wa": 32
              }
          }
      }
    ],
  "status": "SUCCESS"
}

2. GET_NUMBER request method

该请求为我们提供一个电话号码，我们将此号码提供给客户。

该POST请求由Grizzly SMS服务器发送至合作伙伴服务器。

如果 exceptionPhoneSet 数组包含前缀列表（例如 44742 和 44740），则您不得提供以这些前缀之一开头的号码。号码的位数不受前缀长度的限制。

**请求字段:**
字段	类型	是否必填	说明
acción	Cuerda		GET_NUMBER
clave	Cuerda		协议密钥
país	Cuerda		参见数据
servicio	Cuerda		参见数据表
operador	Cuerda		参见数据表
suma	Cur		成功注册服务后您将获得的金额
Excepciónteléfonos	Matriz de Cadena		申请电话号码时禁止提供的前缀列表

**Answer fields**
字段	类型	是否必填	说明
status	Cuerda		(参见状态表)
number	Ulong		带国家代码的电话号码
activationId	Ulong		合作伙伴系统中的激活ID

请求示例：

{
  "action": "GET_NUMBER",
  "key": "qwerty123",
  "country": "russia",
  "operator": "any",
  "service": "tg",
  "sum": 20.00,
}

包含 exceptionPhoneSet 的请求示例

{
  "action": "GET_NUMBER",
  "key": "qwerty123",
  "country": "russia",
  "operator": "any",
  "service": "vk",
  "sum": 10,
  "exceptionPhoneSet": [
    "7918",
    "79281"
  ]
}

响应示例：

{
  "status": "SUCCESS",
  "number": 79157891133,
  "activationId": 571346
}

无号码时的响应示例：

{
  "status": "NO_NUMBERS"
}

3. Delivery of SMS to the Grizzly SMS server using the PUSH_SMS method

该POST请求从合作伙伴服务器发送至Grizzly SMS服务器，地址为：https://api.grizzlysms.com/agent/api/sms

如果收到状态为“CORRECTO”（正确）的响应，请在您的数据库中将该短信标记为已成功送达，并且不要再重复发送。如果返回的状态不是“CORRECTO”，请间隔10秒后重新发送请求，直至收到“CORRECTO”状态为止。

请求字段
字段	类型	是否必填	说明
acción	Cuerda		PUSH_SMS
clave	Cuerda		协议密钥
smsId	Ulong		合作伙伴系统中的短信ID
teléfono	Ulong		接收到短信的电话号码（包含国家代码）
Teléfonodesde	Cuerda		发送短信的发件人名称（可以是字母数字或纯数字）
Texto	Cuerda		短信内容

响应字段组成
字段	类型	是否必填	说明
estado	Cuerda		(参见状态表)

请求示例：

{
  "action": "PUSH_SMS",
  "key": "qwerty123",
  "smsID": 1
  "phone": 447472190082
  "phoneFrom": "Microsoft",
  "text": "Microsoft access code: 5015"
}

响应示例：

{
  "status": "SUCCESS"
}

4. Activation completion request method FINISH_ACTIVATION

该请求由Grizzly SMS服务器发送至合作伙伴服务器，用于完成激活操作。

此POST请求由Grizzly SMS服务器发起。

激活流程完全由Grizzly SMS控制。由于一些不可控因素，我们可能未收到您关于状态变更成功的响应。因此，如果Grizzly SMS重复发送激活完成请求，您需要在您的系统中检查该激活ID是否存在。如果激活记录已存在，请返回“SUCCESS”（成功）状态作为响应。

**请求字段**
字段	类型	是否必填	说明
action	String		FINISH_ACTIVATION
key	String		协议密钥
activationId	Ulong		在第二次请求中获得的激活ID
status	Ulong		参见状态表
响应字段
字段	类型	是否必填	说明
status	String		参见状态表

请求示例：

{
  "action": "FINISH_ACTIVATION",
  "key": "qwerty123",
  "smsId": 100,
  "status": 3
}

响应示例：

{
  "status": "SUCCESS"
}

Testing the protocol

同时号码分配。您应正确处理并发请求，避免重复分配号码。例如，如果您有100个用于印度尼西亚Telegram的号码，而Grizzly SMS同时发起了100次英国Telegram的号码请求，合作伙伴服务器应提供100个不同的唯一号码。如果某个号码被多次分配，则测试将失败。

正确的激活完成。激活状态的变更完全由Grizzly SMS控制。合作伙伴服务器不应自主完成激活。

短信送达确认。一旦收到短信，您必须立即将其转发至Grizzly SMS服务器。如果收到SUCCESS（成功）状态，则不应再次转发该短信。但如果收到其他状态，则应每隔10-20秒重试一次请求。若在已收到SUCCESS状态后仍重复发送短信，测试将失败。

字段类型验证。请仔细检查本文档中规定的字段类型。若违反此要求，测试将失败。

电话号码中的国家代码。电话号码的分配应为数字格式，并包含国家代码。

号码分配时间验证。您必须在3秒内完成号码分配。如果耗时超过3秒，测试将失败。

号码数量验证。如果您在数量请求中声明可提供1000个号码，但在同一时间仅能分配100个，则测试失败。

异常处理验证。如果您在处理号码分配异常时出现错误，则测试失败。

Status Table

**请求字段组成**
状态	说明
SUCCESS	请求成功完成
ERROR	请求执行过程中发生错误。应填写 ERROR 字段以提供错误描述
NO_NUMBERS	无可用号码。此响应仅在号码请求时返回
激活状态
状态	说明
1	禁止为此服务分配号码
3	激活成功售出。您已获得奖励
4	激活已被取消*
5	激活已被退回。客户已获得退款。该号码可能之前已被注册，且可能已启用双重身份验证

**取消机制的工作方式如下：如果一个手机号码已被取消5次，则不应再次分配该号码。可能该号码对客户不适用，或已针对特定服务完成注册。

请求的正确响应：

{
  "status": "SUCCESS",
  //information
}

发生错误时的响应：

{
  "status": "ERROR",
 "error": "Description of the error"
}

Data Table

数据表:
列表	链接
国家列表	完整的国家名称及ID列表请见链接 https://grizzlysms.com/docs
运营商列表
服务列表	完整的服务名称及ID列表请见链接 https://grizzlysms.com/docs

API for price change

本API旨在实现您方对滑块（服务价格）操作的自动化。

API地址为：https://apiagent.grizzlysms.com.
在请求中进行身份验证时，您需要在HTTP请求头中发送您的API密钥，字段为 apikey.

所有数据均以JSON格式传输。
对于GET请求，需发送HTTP请求头 Accept: application/json, 对于POST请求，需发送 - Accept: application/json 和 Content-Type: application/json.

country 参数的可用值位于国家列表的 ID 和 Countries 列中，因此您可以使用 0 或 russia.
service 参数的可用值位于服务列表的 ID 列中。

Terms and fines

提现资金。所赚取资金的提现需通过提交申请进行。合作伙伴可在“提现 ”部分创建提现请求。单笔交易最低提现金额为 100 USDT。请求将在每日 UTC 时间 8:00 至 20:00 之间处理，处理时间为 20 至 180 分钟。如果您符合任何奖金条件（根据网站上公布的条款和条件），请务必在请求的备注中注明。

2FA及错误验证码补偿。Grizzly SMS平台作为中介，将为带有双重身份验证（2FA）和错误验证码的Telegram号码向客户全额退款。Grizzly SMS通过Telegram Expert和TG-GIANT软件自动获取2FA信息。重要提示：对于带有2FA、错误验证码（返回“wrong code”）的号码以及Telegram账户，不会向您收取费用。您可以在激活记录中查看有关2FA或错误验证码的信息。