SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

按国家查询服务价格

比较同一服务在不同国家和运营商的价格及余量。

SMSPVA API
GEThttps://api.smspva.com/activation/serviceprices/{service}

身份验证

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

参数

名称位置类型必填说明
servicepathstring是服务代码。 服务列表 (pattern: "^opt[0-9]{1,8}$")
voicequeryinteger否类型：0 短信，1 来电显示，2 语音。默认值为 0。 (enum: [0,1,2]; default: 0)

无需请求体。

使用说明

比较同一 service 在不同国家和运营商的价格及余量。选好后，用相应代码按运营商获取号码。

列表可能包含 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/serviceprices/opt20?voice=0" \
  --header "apikey: $SMSPVA_API_KEY"

响应

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

HTTP说明
200操作成功
405参数不正确
HTTP 200

操作成功

响应示例

{
  "statusCode": 200,
  "data": {
    "scode": "opt20",
    "sname": "WhatsApp",
    "clist": [
      {
        "ccode": "UK",
        "cname": "United Kingdom",
        "opers": [
          {
            "opcode": "DonorAlpha_UK",
            "price": 0.65,
            "count": 9999
          }
        ]
      }
    ]
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
dataobject响应数据
data.scodestring服务代码。
data.snamestring服务名称.
data.clistarray<object>该服务的可用国家和运营商。
data.clist[].ccodestring国家代码。
data.clist[].cnamestring国家名称。
data.clist[].opersarray<object>
data.clist[].opers[].opcodestringSMSPVA 自营运营商或外部供应商运营商的代码。
data.clist[].opers[].pricenumber运营商价格。 (format: "float")
data.clist[].opers[].countinteger可用号码数量。外部运营商的 9999 表示准确数量未知，可用量可能近似不限。
HTTP 405

参数不正确

响应示例

{
  "statusCode": 405,
  "error": {
    "type": "INVALID_PARAMS",
    "description": "Invalid params."
  }
}

响应字段

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

相关指南

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

国家及运营商价格

比较一个国家内的服务及运营商价格。

所有服务价格

读取各国家的服务价格。

本页内容

身份验证参数使用说明请求示例响应相关指南