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ámetro | Requerido | Nota | Descripción |
---|---|---|---|
Sí | Ver en el perfil en la configuración Clave API | La clave API proporciona acceso a servicios pagos | |
Sí | setStatus | Nombre del método | |
Sí | Valor numérico | ID de activación, obtenido al solicitar el número | |
Sí | Valor numérico | Estado 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 servidor | Descripció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úmeroconst status = 1; # Inserta el nuevo estado de la tabla anteriortry {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 especificadaconst data = await response.json();# Mostramos el contenido de la respuesta del servidorconsole.log(data);} catch (err) {# Si ocurre un error, mostramos un mensaje de errorconsole.error(err);}
Errores posibles
Parámetro | Descripció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. |