Documentación de la API de socios Grizzly SMS

Description of the protocol's operation

El protocolo de socios está diseñado para proporcionar números de teléfono y mensajes SMS entrantes a través de API directamente al servidor Grizzly SMS.

Todas las solicitudes incluyen la CLAVE de parámetro. Esta clave es proporcionada por el personal de soporte y está disponible en la cuenta personal.

Solicitudes de cantidad GET_SERVICES, solicitudes de números GET_NUMBER y solicitudes de finalización de activación FINISH_ACTIVATION se envían directamente desde nuestro servidor al servidor del socio.

Formato de URL : https://GrizzlySMS donde pueden estar los GrizzlySMS partner.ru:port/GrizzlySMS.php o partner.ru/GrizzlySMS.php

GET_SERVICES

GET_NUMBER

PUSH_SMS

FINISH_ACTIVATION

El servidor de SMS Grizzly envía una solicitud de cantidad de números de teléfono utilizando el GET_SERVICES método aproximadamente cada 10-20 segundos.

Si proporciona un recuento > 0 en respuesta, recibirá una solicitud de emisión de un número de teléfono utilizando el GET_NUMBER método.

Después de recibir el GET_NUMBER solicitud, debe proporcionar un
número de teléfono que cumpla con todos los criterios y reenvíenos todos los mensajes SMS entrantes utilizando el PUSH_SMS método. Esto es necesario para que podamos realizar un filtrado claro y objetivo y entregar los mensajes SMS relevantes al servicio adecuado para nuestros clientes.

Al completar todas las tareas necesarias relacionadas con los números de teléfono, recibirá un estado 3 a través del FINISH_ACTIVATION método. Este estado indica que el número de teléfono se registró correctamente y que ha sido recompensado por ello.

Requisitos:

Formato de solicitud/respuesta: JSON
Codificación UTF-8
Utilice siempre un encabezado de agente de usuario en las solicitudes al servidor Grizzly SMS

Tipos de campo:

int: valor entero en el rango de -2 147 483 648 a 2 147 483 647
Uint: valor entero sin signo en el rango de 0 a 2 147 483 647
long: valor entero en el rango de -9 223 372 036 854 775 808 a 9 223 372 036 854 775 807
Ulong: valor entero largo sin signo en el rango de 0 a 9 223 372 036 854 775 807
cur: valor real que contiene hasta 2 decimales, por ejemplo, 177.77
booleano: valores literales verdadero o falso
string: valor de cadena de longitud ilimitada
matriz de cadena: cadena masiva

1. GET_SERVICES number request method

Esta solicitud nos proporciona información sobre la cantidad de números de teléfono para servicios disponibles para la venta.

La solicitud POST se transmite desde el servidor Grizzly SMS al servidor del socio.

! Tenga en cuenta: Si su módem GSM tiene un número limitado de módulos activos simultáneamente, debe proporcionar un recuento igual al número de módulos activos.

Campos de solicitud
Campo	Tipo	Requerido	Descripción
acción	Cuerda		GET_SERVICES
clave	Cuerda		Clave de protocolo

Campos de respuesta:
Campo	Tipo	Requerido	Descripción
estado	Cuerda		Estado de la respuesta(см. Tabla de Estado)
Lista de Paisanos	Matriz de CountryList		Lista de países

CountryList
Campo	Tipo	Requerido	Descripción
país	Cuerda		(ver Tabla de Datos)
Mapa Operativo*	Asociativo matriz		Operador de teclas (ver Tabla de Datos), matriz de servicios asociativos de valor**

* No debe enviar matrices de datos vacías en el mapa de operaciones

** Matriz asociativa de servicios: Clave: un breve nombre de servicio( consulte la Tabla de datos), valor: la cantidad de números de teléfono disponibles para el servicio (tipo: int)

Ejemplo de una solicitud:

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

Ejemplo de una respuesta:

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

2. GET_NUMBER request method

Esta solicitud nos proporciona un número de teléfono que transmitimos al cliente.

La solicitud POST se transmite desde el servidor Grizzly SMS al servidor del socio.

Si la matriz exceptionPhoneSet contiene una lista de prefijos, por ejemplo, 44742 y 44740, no debe proporcionar un número que comience con ninguno de estos prefijos. El número de dígitos no está limitado por el tamaño del prefijo.

**Campos de solicitud:**
Campo	Tipo	Requerido	Descripción
acción	Cuerda		GET_NUMBER
clave	Cuerda		Clave de protocolo
país	Cuerda		ver Tabla de Datos
servicio	Cuerda		ver Tabla de Datos
operador	Cuerda		ver Tabla de Datos
suma	Cur		La cantidad que recibirá por un servicio registrado correctamente
Excepciónteléfonos	Matriz de Cadena		Lista de prefijos que ESTÁ PROHIBIDO dar al solicitar un número de teléfono

**Campos de respuesta**
Campo	Tipo	Requerido	Descripción
estado	Cuerda		(ver Tabla de Estado)
número	Ulong		Número de teléfono con código de país
ID de activación	Ulong		ID de activación en el sistema del socio

Ejemplo de una solicitud:

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

Ejemplo de una solicitud con exceptionPhoneSet

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

Ejemplo de una respuesta:

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

Ejemplo de respuesta en caso de ausencia de números:

{
  "status": "NO_NUMBERS"
}

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

Esta solicitud POST se envía desde el servidor del socio al servidor Grizzly SMS en la dirección: https://api.grizzlysms.com/agent/api/sms

Si recibe una respuesta con el estado "CORRECTO", marque el SMS como entregado correctamente en su base de datos y no lo vuelva a enviar. Si se devuelve un estado que no sea "CORRECTO", repita la solicitud con un retraso de 10 segundos hasta que reciba un estado de" CORRECTO".

Requests fields
Field	Type	Required	Description
action	String		PUSH_SMS
key	String		Protocol key
smsId	Ulong		ID of the SMS in the partner's system
phone	Ulong		Phone number (including the county code) to which the SMS was sent
phoneFrom	String		The sender's name (may be either alphanumeric or numeric) which sent the SMS
Text	String		SMS text

Состав полей ОТВЕТА
Field	Type	Required	Description
status	String		(see Status Table)

Ejemplo de una solicitud:

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

Ejemplo de una respuesta:

{
  "status": "SUCCESS"
}

4. Activation completion request method FINISH_ACTIVATION

Esta solicitud se transmite desde el servidor Grizzly SMS al servidor del socio para completar la activación.

Solicitud POST iniciada desde el servidor de SMS Grizzly al servidor del socio.

La gestión de la activación está totalmente controlada por Grizzly SMS. Debido a factores fuera de nuestro control, es posible que no recibamos una respuesta suya con respecto a un cambio de estado exitoso. Por lo tanto, si Grizzly SMS envía una solicitud repetida de finalización de la activación, debe verificar la existencia del ID de activación en su extremo. Si la activación existe, envíe un estado de ÉXITO en respuesta.

**Campos de solicitud**
Campo	Tipo	Requerido	Descripción
acción	Cuerda		FINISH_ACTIVATION
clave	Cuerda		Clave de protocolo
ID de activación	Ulong		ID de activación obtenido en la segunda solicitud
estado	Ulong		Ver Tabla de Estado
Campos de respuesta
Campo	Tipo	Requerido	Descripción
estado	Cuerda		Ver Tabla de Estado

Ejemplo de una solicitud:

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

Ejemplo de una respuesta:

{
  "status": "SUCCESS"
}

Testing the protocol

Emisión Simultánea de Números. Debe manejar las solicitudes simultáneas correctamente y no emitir números repetidamente. Por ejemplo, si tiene 100 números para Telegram Indonesia y Grizzly SMS realiza simultáneamente 100 solicitudes para Telegram Reino Unido, el servidor asociado debe proporcionar 100 números únicos. Si se emite un número varias veces, la prueba falla.

Finalización De La Activación De Crrect. El cambio en el estado de activación está completamente controlado por Grizzly SMS. El servidor asociado no debe completar activaciones de forma autónoma.

Verificación de Entrega de SMS. Una vez que reciba un SMS, debe reenviarlo inmediatamente al servidor de SMS de Grizzly. Si recibe un estado de ÉXITO, no debe reenviar el SMS nuevamente. Sin embargo, si recibe un estado diferente, debe volver a intentar la solicitud cada 10-20 segundos. Si se emite un SMS nuevamente después de recibir un estado DE ÉXITO, la prueba falla.

Verificación del Tipo de Campo. Verifique minuciosamente los tipos de campo especificados en esta documentación. Si se viola esta condición, la prueba falla.

Código de País en el Número de Teléfono. La emisión del número de teléfono debe estar en formato digital e incluir el código del país.

Verificación del Tiempo de Emisión del Número. Debe emitir números con un retraso de menos de 3 segundos. Si tarda más de 3 segundos, la prueba falla.

Verificación de Cantidad Numérica. Si emite 1000 números en una solicitud de cantidad de números, pero solo se emiten 100 al mismo tiempo, entonces la prueba ha fallado.

Verificación del Manejo de Excepciones. Si maneja incorrectamente las excepciones para emitir un número, entonces la prueba ha fallado.

Status Table

**Composición de los campos de consulta**
Estado	Descripción
SUCCESS	La solicitud se completó con éxito
ERROR	Error durante la ejecución de la solicitud. El campo de ERROR debe completarse con una descripción
NO_NUMBERS	No hay números disponibles. Esta respuesta solo se devuelve para una solicitud de número
Estado de Activación
Estado	Descripción
1	Está prohibido emitir un número para este servicio
3	La activación se vendió con éxito. Has recibido una recompensa
4	Se canceló la activación*
5	La activación ha sido devuelta. El cliente ha recibido un reembolso por la activación. Este número puede haberse registrado previamente y haber habilitado la autenticación de dos factores en el número

**El mecanismo de cancelación funciona de la siguiente manera: Si un número de teléfono ha sido cancelado 5 veces, no debe emitir el mismo número nuevamente. Es posible que el número no fuera adecuado para el cliente o que ya estuviera registrado para el servicio específico.

Respuesta satisfactoria a la solicitud:

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

Respuesta en caso de error:

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

Data Table

**Tabla de Datos:**
Listas	Enlaces
Lista de países	La lista completa de países con nombres e identificaciones se puede encontrar en el enlace https://grizzlysms.com/docs
Lista de operadores	Por el momento, el desglose por operadores está en desarrollo, por lo que debe pasar el valor 'any'. Una vez implementada esta funcionalidad, te avisaremos a través del chat de soporte técnico.
Listado de servicios	La lista completa de servicios con nombres e identificaciones se puede encontrar en el enlace https://grizzlysms.com/docs

API for price change

Esta API tiene como objetivo la automatización del trabajo con los controles deslizantes de su lado (precios de los servicios).

La API se puede encontrar en esta dirección https://apiagent.7grizzlysms.com.Para la autenticación en las solicitudes, debe enviar su clave API en la API de encabezado HTTP.

Todos los datos se transmiten en formato JSON.

En cuanto a las solicitudes GET, es necesario enviar HTTP-header Accept: application/json, as for POST request - Accept: application/json and Content-Type: application/json.

Los valores disponibles del parámetro país se encuentran en Lista de países en las columnas ID y Países, entonces, puede usar 0 y rusia.

Los valores disponibles del parámetro de servicio se encuentran en Listado de servicios en la columna ID.

Terms and fines

Fondos de retiro. El retiro de los fondos ganados se lleva a cabo mediante solicitudes. Un socio puede crear una solicitud en la sección Retiro. El retiro de ganancias de 100 USDT está disponible para una transacción. Las solicitudes se procesan diariamente de 8:00 a 20:00 (UTC) en un plazo de 20 a 180 minutos. Si se le promete algún bono (de acuerdo con los términos y condiciones publicados en el sitio web), asegúrese de indicarlo en los comentarios a la solicitud.

Compensaciones por 2FA y código incorrecto. La plataforma Grizzly SMS, como intermediario, compensa a los clientes por los números de Telegram con 2FA y códigos incorrectos en su totalidad. Grizzly SMS recibe información sobre 2FA automáticamente de Telegram Expert y TG-GIANT software. Importante: Fondos para números con 2FA y código incorrecto (responda 'código incorrecto') y en cuentas de Telegram no se cobran. Puede ver la información sobre 2FA o wronge_code en el Historial de Activación.