Consulta de saldo de 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 un control de gastos y un 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 consulta 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 pagos | |
| 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"; # Reemplaza 'API_KEY' con tu 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 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 |