Cambio de estado de activación

El método setStatus permite gestionar el estado de activación de un número virtual a través de la API SMS.online. Se utiliza para cambiar el estado actual del número en el sistema, por ejemplo, al finalizar la activación o cancelar el uso del número.

Este método es útil para automatizar procesos relacionados con la gestión de números virtuales, cuando es necesario actualizar rápidamente el estado de activación en tiempo real.

Tras una solicitud exitosa, el sistema actualiza el estado del número, incluyendo información sobre la activación exitosa, cancelación u otras operaciones relacionadas con el uso del número. Esto permite mantener el estado de activación actualizado en sistemas integrados.

Ejemplo de solicitud:

Datos de entrada

ParámetroRequeridoNotaDescripción
Ver en el perfil en la configuración Clave APILa clave API proporciona acceso a servicios pagos
setStatusNombre del método
Valor numéricoID de activación, obtenido al solicitar el número
Valor numéricoEstado de la activación

¿Qué estado enviar y cuándo?

Justo después de recibir el número, este está en espera de SMS.

Tienes las siguientes acciones disponibles:

8 - Cancelar activación

Justo después de recibir el código:

3 - Solicitar otro SMS

6 - Confirmar el código SMS y completar la activación

Para activar con estado 3:

6 - Confirmar el código SMS y completar la activación

Respuesta del servidor

Respuesta del servidorDescripción
Esperando reactivación
Activación completada con éxito
Activación cancelada

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 status = 1; # Inserta el nuevo estado de la tabla anterior
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=setStatus&id=${id}&status=${status}`);
# 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
Clave API incorrecta
Acción incorrecta
Error en la consulta
Tiempo por el cual la cuenta está bloqueada
Cuenta no activa
No se puede cancelar el número en los primeros 2 minutos
Activación no encontrada
Estado incorrecto
ID incorrecto o ID no es un número.