Consultar saldo
Consulta el saldo actual de la cuenta.
Autenticación
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
apikey | header | string | Sí | Tu clave API |
Parámetros
Sin parámetros de ruta o consulta. No requiere cuerpo.
Cómo usar este método
Consulta el saldo disponible en tu cuenta. La respuesta devuelve data.balance como cadena; conserva ese tipo al mostrar el importe.
Ejemplos de solicitud
Requisitos y configuración del entorno. cURL usa un shell POSIX. El ejemplo JavaScript también es válido en TypeScript sobre Node.js. Java utiliza el cliente estándar y muestra JSON sin analizar; usa la biblioteca JSON de tu aplicación.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --fail-with-body --max-time 30 --request GET \
--url "https://api.smspva.com/activation/balance" \
--header "apikey: $SMSPVA_API_KEY"Respuestas
Los ejemplos muestran el formato de respuesta. Los precios, las cantidades y los datos de cuenta son orientativos; consulta la API para obtener valores actuales.
| HTTP | Descripción |
|---|---|
| 200 | Operación completada |
| 400 | Falta la cabecera apikey, está vacía o su longitud no es válida. |
HTTP 200
Operación completada
Respuesta ilustrativa
{
"statusCode": 200,
"data": {
"balance": "10.50"
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
data | object | Datos de respuesta |
data.balance | string | Saldo |
HTTP 400
Falta la cabecera apikey, está vacía o su longitud no es válida.
Respuesta ilustrativa
{
"statusCode": 400,
"error": {
"type": "APIKEY_NOT_SET",
"description": "No ApiKey found"
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | |
error | object | |
error.type | string | |
error.description | string |
Guías relacionadas
Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.