SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

Consultar saldo

Consulta el saldo actual de la cuenta.

SMSPVA API
GEThttps://api.smspva.com/activation/balance

Autenticación

NombreUbicaciónTipoObligatorioDescripción
apikeyheaderstringSí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.

HTTPDescripción
200Operación completada
400Falta 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

NombreTipoDescripción
statusCodeintegerCódigo de estado del resultado
dataobjectDatos de respuesta
data.balancestringSaldo
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

NombreTipoDescripción
statusCodeinteger
errorobject
error.typestring
error.descriptionstring

Guías relacionadas

Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.

En esta página