SMSPVA / DOCUMENTATION
代码示例
使用八种常用语言和工具发送直接 HTTP 请求。
SMSPVA API
每个 Activation V2 接口均提供 cURL、JavaScript、TypeScript、Python、PHP、Go、C# 和 Java 示例。示例遵循文档中的 HTTP 方法和 apikey 请求头，不依赖 SMSPVA SDK。
运行环境
| 示例 | 环境 | 运行 |
|---|---|---|
| cURL | cURL 7.76+，macOS、Linux 或 WSL 的 POSIX shell | 在 shell 中执行 |
| JavaScript | Node.js 22.16+ | node Example.mjs |
| TypeScript | 含 Node 类型的 ESM 项目 | Example.mts；使用 NodeNext/ES2022 编译或现有 TS 执行器 |
| Python | Python 3.10+，标准库 | python Example.py |
| PHP | PHP 8.1+，ext-curl | php Example.php |
| Go | Go 1.20+，标准库 | go run Example.go |
| C# | .NET 8+ 控制台项目 | 写入 Program.cs；dotnet run |
| Java | JDK 11+，标准库 | java Example.java |
Java 标准库不包含 JSON 解析器，因此示例保留原始 JSON，请用应用已有的 JSON 库读取字段。其他语言示例会解析响应。JavaScript 和 TypeScript 用于服务器上的 Node.js，不是浏览器代码。
环境变量
# macOS / Linux / WSL
export SMSPVA_API_KEY="YOUR_API_KEY"# PowerShell
$env:SMSPVA_API_KEY = "YOUR_API_KEY"
$env:SMSPVA_ORDER_ID = "123456" # 替换为实际订单 ID订单接口要求 SMSPVA_ORDER_ID。号码状态接口要求 SMSPVA_NUMBER，不含国家电话区号。国家、服务和运营商使用原文档中的示例默认值，可以修改代码或设置 SMSPVA_COUNTRY、SMSPVA_SERVICE、SMSPVA_OPERATOR。cURL 中的代码为字面值，请直接修改。
实际代码参见国家和服务及运营商。支持 voice 的示例使用 voice=0。来电显示改为 1，语音改为 2，并先检查权限设置。
Receive SMS 另支持可选请求头 partnerkey，用于成功接收短信时的推荐记账。
响应与重试
示例设置 30 秒客户端超时，不自动重试。先识别 202 / SMS_NOT_YET_RECEIVED，再处理一般错误。cURL 输出响应体，Java 保留原始 JSON 供应用解析。
重复等待请求参见轮询指南。购买结果不明时，先查看当前订单再决定是否重新申请。