快速入门

1. 获取 API 密钥复制链接

登录 SMSPVA，在账户菜单中打开 Profile and ApiKey。

将密钥保存在服务器环境变量中，让应用读取即可。不要把密钥写进公开的浏览器代码或提交到代码仓库。

export SMSPVA_API_KEY="YOUR_API_KEY"

2. 查询余额复制链接

Activation V2 的服务器地址是 **https://api.smspva.com**，使用 apikey 请求头。

cURL 示例使用 POSIX shell 语法，适用于 macOS、Linux 或 WSL。在 Windows 中，也可以从 PowerShell 运行 JavaScript 或 Python 示例。JavaScript 需要 Node.js 22.16+；Python 仅使用标准库，要求 Python 3.10+。

curl --fail-with-body --max-time 30 \
  'https://api.smspva.com/activation/balance' \
  --header "apikey: $SMSPVA_API_KEY"

3. 理解结果复制链接

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

实际响应会显示你自己账户的余额。balance 是字符串，显示金额时请保留这一类型。使用 data 前，先检查 HTTP 响应和 API 错误。

密钥缺失或长度不正确时，会返回 HTTP 400 和 APIKEY_NOT_SET。请求超时则表示尚未确认 API 的处理结果。

下一步复制链接

阅读余额接口参考、SDK 计划或 MCP 与 Markdown。

接下来阅读激活流程、完整接口参考及八种语言示例。购买请求超时后不要自动重试：首次请求可能已经成功。