Activation V2
SMSPVA / API REFERENCE
所有号码余量
按国家、运营商和服务读取号码余量。
SMSPVA API
身份验证
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
apikey | header | string | 是 | 你的 API 密钥 |
参数
无需路径参数、查询参数或请求体。
使用说明
按国家、运营商和服务查看号码余量。查询单个国家可用国家号码余量，比较费用可用所有服务价格。
请求示例
运行环境及配置. 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/countnumbers" \
--header "apikey: $SMSPVA_API_KEY"响应
下方示例用于说明响应格式。价格、余量和账户数据仅为示例，实际数值请以 API 响应为准。
| HTTP | 说明 |
|---|---|
| 200 | 操作成功 |
| 402 | 已超过 API 请求频率限制。 |
HTTP 200
操作成功
响应示例
{
"statusCode": 200,
"data": [
{
"operator": "Primetel_CY",
"country": "CY",
"services": [
{
"service": "opt0",
"total": 12
}
]
}
]
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 结果状态码 |
data | array<object> | 响应数据 |
data[].operator | string | 运营商 |
data[].country | string | 国家 |
data[].services | array<object> | |
data[].services[].service | string | 服务 |
data[].services[].total | integer | 号码数量 |
HTTP 402
已超过 API 请求频率限制。
响应示例
{
"statusCode": 402,
"error": {
"type": "RATELIMIT_EXCEED",
"description": "Rate limit exceeded."
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | |
error | object | |
error.type | string | |
error.description | string |
相关指南
修改订单的请求发生网络故障时，先检查订单状态，再决定是否重试。