FAQAPI

Renovación del alquiler de un número virtual

El método continueRentNumber se utiliza para extender el alquiler de un número virtual a través de la API SMS.online. Permite automatizar el proceso de renovación, asegurando el uso continuo del número alquilado para recibir SMS sin riesgo de perderlo.

Este método está diseñado para situaciones en las que se necesita usar el mismo número durante un tiempo prolongado. Puedes especificar el período de renovación, tras lo cual el sistema actualizará la duración del alquiler y te enviará una confirmación de la renovación exitosa.

Una solicitud exitosa devuelve un objeto con información sobre el alquiler actualizado, incluyendo el identificador del número, la nueva duración del alquiler y el monto a debitar. Esto garantiza la estabilidad en la recepción de SMS durante el período extendido.

Ejemplo de solicitud:

Datos de entrada

ParámetroRequeridoNotaDescripción
SíVer en el perfil en la configuración Clave APILa clave API proporciona acceso a servicios pagos
SícontinueRentNumberNombre del método
SíValor numéricoID de activación, obtenido al solicitar el número
Sí4, 8, 12, 24, 72, 168, 360, 720, 2160Tiempo de alquiler en horas

Respuesta del servidor

JSON
{
  "status": "success",
  "phone": {
    "id": 1049,
    "endDate": "2020-01-31T12:01:52",
    "number": "79959707564"
  }
}

Ejemplo de código

const api_key = "API_KEY"; # Reemplaza 'API_KEY' con tu clave API real.
const id = 1; # Inserta el ID de activación obtenido al solicitar el número
const rent_time = 1; # Inserta el tiempo de renovación en horas de la tabla anterior
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=continueRentNumber&id=${id}&rent_time=${rent_time}`);
# Realizamos una solicitud GET a la URL especificada
const data = await response.json();
# Mostramos el contenido de la respuesta del servidor
console.log(data);
} catch (err) {
# Si ocurre un error, mostramos un mensaje de error
console.error(err);
}

Errores posibles

ParámetroDescripción
Acción incorrecta
Clave API incorrecta
Error en la consulta
Tiempo por el cual la cuenta está bloqueada
Cuenta no activa
ID de alquiler no especificado
Número alquilado no por ti (ID de alquiler incorrecto)
Hora de renovación incorrecta
Saldo no encontrado
Falta o estado indicado incorrectamente