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.
Después de 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 pagados | |
| 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 activación |
¿Qué estado enviar y cuándo?
Justo después de recibir el número, este está a la espera de un 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"; # Reemplace 'API_KEY' con su clave API real.const id = 1; # Inserte el ID de activación obtenido al solicitar el númeroconst status = 1; # Inserte 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 ocurrió un error, mostramos un mensaje de errorconsole.error(err);}Posibles errores
| Parámetro | Descripción |
|---|---|
| Clave API incorrecta | |
| Acción incorrecta | |
| Error en la consulta | |
| Tiempo por el cual la cuenta está bloqueada | |
| Cuenta inactiva | |
| 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. |