SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

服务价格

读取一个国家和服务的价格及运营商价格。

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

身份验证

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

参数

名称位置类型必填说明
countrypathstring是大写两字符国家代码，采用 API 指定的 ISO 3166-2 格式。 国家列表
servicepathstring是服务代码。 服务列表
voicequeryinteger否类型：0 短信，1 来电显示，2 语音。默认值为 0。 (enum: [0,1,2]; default: 0)

无需请求体。

使用说明

查询指定 country 和 service 的价格，包括 priceByOperators 中的运营商价格。代码见基础数据，并可查看余量或比较其他国家。

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

响应

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

HTTP说明
200操作成功
405country 或 service 参数不正确。
HTTP 200

操作成功

响应示例

{
  "statusCode": 200,
  "data": {
    "service": "opt0",
    "serviceDescription": "myopinions & erewards",
    "country": "KZ",
    "price": "2.34",
    "priceByOperators": {
      "Other_KZ": "0.39",
      "Activ_KZ": "0.39"
    }
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
dataobject响应数据
data.servicestring服务
data.serviceDescriptionstring服务说明.
data.countrystring国家
data.pricestring价格。
data.priceByOperatorsobject按移动运营商划分的价格。
data.priceByOperators.*string
HTTP 405

country 或 service 参数不正确。

响应示例

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

响应字段

名称类型说明
statusCodeinteger
errorobject
error.typestring
error.descriptionstring

相关指南

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

国家号码余量

查询指定国家的可用号码。

国家及运营商价格

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

本页内容

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