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: Solicitud de número
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&maxPrice=$maxPrice

&action=getNumber
$api_key — su clave API (Configuración);
$service — código del servicio;
$country — código del país;
$maxPrice — precio máximo por el que estás dispuesto a comprar el número.

Errores posibles:
BAD_KEY — verifique su clave API;
NO_NUMBERS — repita la solicitud o elija otro país.
the number has not been issued — repita la solicitud o seleccione otro país.

Ejemplo de respuesta exitosa:

ACCESS_NUMBER:38496653:66846426435

Donde 38496653 es el ID de activación. 66846426435 es el número de teléfono.

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
API de alquiler: 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
API de alquiler: Cambios de estado del alquiler
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

$api_key – su clave API (Configuración);
$id – ID del alquiler;
$status – estado del alquiler:
1 – finalizar alquiler;
2 – cancelar alquiler.

La respuesta del servicio estará en formato JSON:

{
  "status": "estado"
}

 

Ejemplo de respuesta exitosa:

{
  "status": "success"
}

Ejemplo de respuesta con error:

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

 

Possible errors:
BAD_KEY – verifique su clave API;
NO_ID_RENT – verifique el ID del alquiler;
INVALID_PHONE – el ID del alquiler no existe;
INCORECT_STATUS – verifique el estado del alquiler;
ALREADY_FINISH – el alquiler ya fue finalizado;
ALREADY_CANCEL – el alquiler ya fue cancelado;
CANT_CANCEL – no se puede cancelar (se recibió un SMS o ya pasaron 20 minutos);
SQL_ERROR – error del servidor SQL, repita la solicitud más tarde;
SERVER_ERROR – error del servidor, repita la solicitud más tarde.

Pruebe este método ahora
Your API-key
ID rent
Rent status
Alquiler API
API de alquiler: 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
API de alquiler: 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)