Contraer contenido

API —  this is the protocol of interaction between your software and our activation server. The API is needed to automate the process of receiving SMS messages on your side

Our API is compatible with the sms-activate API

All requests must have an API key in the form of the api_key parameter

Activaciones de API
Activation API: Request a number
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country

&action=getNumber
$api_key — your API key (Settings);
$service — service code;
$country — country code.
If not specified, the Russian number will be selected by default.

Possible errors:
BAD_KEY — check your API key;
NO_NUMBERS — repeat a request or choose another country.
the number has not been issued — repeat the request or select another country

The example of successful answer:

ACCESS_NUMBER:38496653:66846426435

Where 38496653 is activation id. 66846426435 is a phone number.

Pruebe este método ahora
Your API key
Service code
Country code
Activaciones de API
API de activación: Cambios en el estado de activación

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

&action=setStatus

$api_key —su clave API (Ajustes);
$id — id de activación;
$status — estado de activación:
-1 — cancelar activación
1 — informar sobre la disponibilidad del número (sms enviado al número);
3 — espere el siguiente código en el mismo número;
6 — activación completa;
8 — cancelar activación.

Respuestas de servicio:
ACCESS_READY — la disponibilidad del número ha sido confirmada
ACCESS_RETRY_GET — esperando un nuevo sms
ACCESS_ACTIVATION — el servicio se ha activado correctamente
ACCESS_CANCEL — activación cancelada

Posibles errores:
ERROR_SQL — Error de SQL server
NO_ACTIVATION — el id de activación no existe
BAD_SERVICE — nombre de servicio incorrecto
BAD_STATUS — estado incorrecto
BAD_KEY — Clave API no válida
BAD_ACTION — acción incorrecta

Pruebe este método ahora
Your API key
Activation id
Activation status
Activaciones de API
API de activación: Obtenga el estado de activación

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

&action=getStatus
$api_key — su clave API (Ajustes);
$id — id de activación.

Respuestas de servicio:
STATUS_WAIT_CODE — esperando sms
STATUS_WAIT_RETRY:$lastcode — esperando el refinamiento del código (donde last lastcode es el último código inadecuado)
STATUS_WAIT_RESEND — esperando a que se vuelva a enviar el sms (el software debe hacer clic en reenviar sms y realizar un cambio de estado a 6)
STATUS_CANCEL — activación cancelada
STATUS_OK:$code — código recibido (donde code code es el código de activación).

Posibles errores:
NO_ACTIVATION — el id de activación no existe
BAD_KEY — Clave API no válida
BAD_ACTION — acción incorrecta

Pruebe este método ahora
Your API key
Activation id
Activaciones de API
API de Activación: Solicitud de Saldo
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

&action=getBalance
$api_key — su clave API (Ajustes);

Respuesta del servicio:
ACCESS_BALANCE:$balance (donde balance balance es el saldo de la cuenta)

Posibles errores:
BAD_KEY — Clave API no válida

Pruebe este método ahora
Your API key
Activaciones de API
API de activación: Obtenga los precios actuales por país
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

&action=getPrices
$api_key — su clave API (Ajustes);
$service — código de servicio;
$country — código de país.

Respuestas de servicio en el formato 
Por ejemplo, una solicitud del formulario https://api.grizzlysms.com/stubs/handler_api.php?api_key=YOURKEY&action=getPrices&country=0

{
  "Country": {
    "Service": {
      "cost": Cost,
      "count": Quantity
    }
  }
}
Pruebe este método ahora
Your API key
Service code
Country code
Alquiler API
API de alquiler: solicite un número

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&country=$country&rent_time=$time

$api_key – su clave API (Configuración);
$service – código de servicio;
$country – código de país;
$time – tiempo de alquiler (min. de 4 horas).

La respuesta del servicio estará en formato json:

{
  "status": "status",
  "phone": {
    "id": ”id rent”,
    “endDate”: ”rent expiration date”,
    “number”:”phone number”
  }
}

 

El ejemplo de respuesta exitosa:

{
  "status": "success",
  "phone": {
    "id": ”38496653”,
    “endDate”: ”2023-12-31T19:30:52”,
    “number”: ”66846426435”
  }
}

 

Ejemplo de una respuesta con un error:

{
  "status": "error",
  "error": "BAD_KEY"
}

 

Posibles errores:
BAD_KEY – verifique su clave API;
BAD_COUNTRY – comprobar código de país;
BAD_SERVICE – verifique el código de servicio;
INVALID_TIME – consultar horas de conteo;
NO_BALANCE – fondos insuficientes en la cuenta;
NO_NUMBERS – repita una solicitud o elija otro país;
SERVER_ERROR – error del servidor, repetir solicitud más tarde.

Pruebe este método ahora
Your API-key
Service code
Country code
Rental time (min. of 4 hours)
Alquiler API
API de alquiler: continuar alquiler
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

$api_key – su clave API (Configuración);
$time - tiempo de alquiler (min. de 4 horas).

La respuesta del servicio estará en formato json:

{
  "status": "status",
  "phone": {
    "id": "id rent",
    "endDate": "rent expiration date",
    "number": "phone number"
  }
}

El ejemplo de respuesta exitosa:

{
  "status": "success",
  "phone": {
    "id": "38496653",
    "endDate": "2023-12-31T19:30:52",
    "number": "66846426435"
  }
}

 

Ejemplo de una respuesta con un error:

{
  "status": "error",
  "error":"BAD_KEY"
}

 

Posibles errores:
BAD_KEY – verifique su clave API;
INVALID_TIME – consultar horas de conteo;
NO_ID_RENT – verificar alquiler de identificación;
NO_BALANCE – fondos insuficientes en la cuenta;
RENT_DIE – este número ya no está disponible, seleccione un nuevo número;
SERVER_ERROR – error del servidor, repita la solicitud más tarde.

Pruebe este método ahora
Your API-key (Settings)
Rental time (min. of 4 hours)
Alquiler API
Rent API: historial de alquileres
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentHistory&id=$id

$api_key – su clave API (Configuración);
$id – alquiler de id;

La respuesta del servicio estará en formato json:

{
  "status": "status",
  "quantity": "number of times rented",
  "values": {
    “1”: {
      “date”: ”rent commencement date”,
      “price”: rentalCost,
      “hours”:rentDuration
    }
  }

El ejemplo de respuesta exitosa:

{
  "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
    }
  }
}

Un ejemplo de una respuesta exitosa con un número vacío:

{
  "status": "success",
  "values": {}
}

Ejemplo de una respuesta con un error:

{
  "status": "error",
  "error": "SQL_ERROR"
}

Posibles errores:
BAD_KEY – verifique su clave API;
NO_ID_RENT – verificar alquiler de identificación;
SQL_ERROR – Error de SQL Server, repetir solicitud más tarde.

Pruebe este método ahora
Your API-key
ID rent
Alquiler API
Rent API: rent status changes
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

$api_key – your API-key (Settings);
$id – id rent;
$status – rent status:
1 – finish rent;
2 – cancel rent.

Service response will be in json format:

{
  "status": "статус"
}

 

The example of successful answer:

{
  "status": "success"
}

Example of an answer with an error:

{
  "status": "error",
  "error": "CANT_CANCEL"
}

 

Possible errors:
BAD_KEY – check your API-key;
NO_ID_RENT – check id rent;
INVALID_PHONE – id rent nonexistent;
INCORECT_STATUS – check rent status;
ALREADY_FINISH – rent has already been finalized;
ALREADY_CANCEL – rent has already been canceled;
CANT_CANCEL – cannot be canceled (SMS received or 20 minutes have passed);
SQL_ERROR – SQL server error, repeat request later;
SERVER_ERROR – server error, repeat request later.

Pruebe este método ahora
Your API-key
ID rent
Rent status
Alquiler API
Rent API: obtenga el estado de activación
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id

$api_key – su clave API (Configuración);
$id – alquiler de id.

La respuesta del servicio estará en formato json:

{
  "status": "status",
  "quantity": "number of codes",
  "values": {
     "0": {
       "phoneFrom": "phone number",
       "service": "service code",
       "text": "sms code",
       "date": "date of SMS receipt"
    }
  }
}

El ejemplo de respuesta exitosa:

{
  "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"
    }
  }
}

 

Ejemplo de una respuesta exitosa con una lista vacía de códigos:

{
  "status": "success",
  "values":{}
}

 

Ejemplo de una respuesta con un error:

{
  "status": "error",
  "error": "NO_ID_RENT"
}

 

Posibles errores:
BAD_KEY – verifique su clave API;
NO_ID_RENT – verificar alquiler de identificación;
INVALID_PHONE – id realquiler de identificación inexistentent nonexistent;
SERVER_ERROR – error del servidor, repetir solicitud más tarde.

Pruebe este método ahora
Your API-key
ID rent
Alquiler API
Rent API: obtenga los precios actuales por país
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentPrices&service=$service&country=$country&rent_time=$time

$api_key – su clave API (Configuración);
$service – código de servicio;
$country – código de país;
$time - tiempo de alquiler (min. de 4 horas).

La respuesta del servicio estará en formato json:

{
  "status": "status",
  "values": {
    "Country": {
      "Service": {
        "cost": cost,
        "count": number,
        "max_hours": maximumRentalHours
      }
    }
  }
}

 

El ejemplo de respuesta exitosa:

{
  "status": "success",
  "values": {
    "0": {
      "tg": {
        "cost": 12,
        "max_hours": 10,
        "count": 15
      }
    }
  }
}

 

Ejemplo de una respuesta con un error:

{
  "status": "error",
  "error": "INVALID_TIME"
}

 

Posibles errores:
BAD_KEY – verifique su clave API;
BAD_COUNTRY – comprobar código de país;
BAD_SERVICE – verifique el código de servicio;
INVALID_TIME – consultar horas de conteo;
NO_NUMBERS – repita una solicitud o elija otro país;
SERVER_ERROR – error del servidor, repetir solicitud más tarde.

Pruebe este método ahora
Your API-key
Service code
Country code
Rental time (min. of 4 hours)