Consulta del estado de activación
El método getStatus permite obtener el estado actual de activación de un número virtual a través de la API SMS.online. Se utiliza para verificar automáticamente el estado de activación en plataformas externas que requieren confirmación por SMS.
Este método permite rastrear el proceso de activación después de recibir el número y proporciona información sobre si se ha entregado el mensaje con el código de confirmación, además de mostrar el estado actual del número en el sistema.
Una solicitud exitosa devuelve una cadena con información sobre el estado actual de activación, el estado del mensaje y el código (si fue recibido). Este método es conveniente para integrarse en sistemas que requieren control operativo del estado en tiempo real.
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í | getStatus | Nombre del método | |
Sí | Valor numérico | ID de activación, obtenido al solicitar el número |
Respuesta del servidor
Respuesta del servidor | Descripción |
---|---|
Esperando código | |
Esperando reenvío de SMS | |
Cancelado | |
Éxito (donde $CODE es el código de activación) |
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úmerotry {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getStatus&id=${id}`);# 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 |
---|---|
Acción incorrecta | |
Clave API incorrecta | |
Error en la consulta | |
Tiempo por el cual la cuenta está bloqueada | |
Cuenta no activa | |
Activación no encontrada |