SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

运营商

查询国家的运营商代码,包括外部供应商运营商。

SMSPVA API
GEThttps://api.smspva.com/activation/operators/{country}

身份验证

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

参数

名称位置类型必填说明
countrypathstring是国家代码

无需请求体。

使用说明

根据 country 查询可用运营商。需要指定运营商申请号码时,使用返回的代码。

列表可能包含 SMSPVA 自营运营商和外部供应商运营商,例如 DonorAlpha_UK,两者的代码用法相同。外部号码的稳定性可能不及 SMSPVA 自营的真实 SIM 卡。外部运营商余量为 9999 时,表示无法确定准确数量,可用量可能近似不限。

请求示例

运行环境及配置. 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/operators/UK" \
  --header "apikey: $SMSPVA_API_KEY"

响应

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

HTTP说明
200操作成功
400未收到 API 密钥。
HTTP 200

操作成功

响应示例

{
  "statusCode": 200,
  "data": {
    "country": "UK",
    "operators": [
      "DonorAlpha_UK"
    ]
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
dataobject响应数据
data.countrystring国家代码
data.operatorsarray<string>可用运营商列表
HTTP 400

未收到 API 密钥。

响应示例

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

响应字段

名称类型说明
statusCodeinteger结果状态码
errorobject错误详情
error.typestring错误类型
error.descriptionstring错误说明

相关指南

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

本页内容