SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

查询余额

读取当前账户余额。

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

身份验证

名称位置类型必填说明
apikeyheaderstring是你的 API 密钥

参数

无需路径参数、查询参数或请求体。

使用说明

查询账户可用余额。响应中的 data.balance 是字符串,显示金额时请保留这一类型。

请求示例

运行环境及配置. cURL 使用 POSIX shell。JavaScript 示例也可用于 Node.js TypeScript 项目。Java 使用标准 HTTP 客户端并输出原始 JSON;请使用应用的 JSON 库读取响应字段。

: "${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"

响应

下方示例用于说明响应格式。价格、余量和账户数据仅为示例,实际数值请以 API 响应为准。

HTTP说明
200操作成功
400缺少 apikey 请求头、值为空或长度不正确。
HTTP 200

操作成功

响应示例

{
  "statusCode": 200,
  "data": {
    "balance": "10.50"
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
dataobject响应数据
data.balancestring余额
HTTP 400

缺少 apikey 请求头、值为空或长度不正确。

响应示例

{
  "statusCode": 400,
  "error": {
    "type": "APIKEY_NOT_SET",
    "description": "No ApiKey found"
  }
}

响应字段

名称类型说明
statusCodeinteger
errorobject
error.typestring
error.descriptionstring

相关指南

修改订单的请求发生网络故障时,先检查订单状态,再决定是否重试。

本页内容