Consulta del saldo de la cuenta
El método getBalance se utiliza para obtener el saldo actual de la cuenta a través de la API de SMS.online. Permite automatizar la verificación de los fondos disponibles, asegurando el control de gastos y el funcionamiento estable del servicio.
Se recomienda este método para sistemas que requieren un control regular del estado de la cuenta y la toma de decisiones sobre recargas oportunas. Esto ayuda a evitar interrupciones en el servicio por falta de fondos.
Una solicitud exitosa devuelve un objeto con información sobre el saldo actual, incluyendo los fondos disponibles en el momento de la consulta. Este método es especialmente útil en sistemas automatizados que requieren monitoreo del saldo 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 pagados | |
| Sí | getBalance | Nombre del método |
Respuesta del servidor
ACCESS_BALANCE:BALANCEBALANCE - Saldo de la cuenta en dólares
Ejemplo de código
const api_key = "API_KEY"; # Reemplace 'API_KEY' con su clave API real.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getBalance`);# 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 |
|---|---|
| Acción incorrecta | |
| Clave API incorrecta | |
| Error en la consulta | |
| Tiempo por el cual la cuenta está bloqueada | |
| Cuenta inactiva |