SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

接收质量指标

比较同一服务在不同国家的短信接收质量指标。

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

身份验证

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

参数

名称位置类型必填说明
servicepathstring是服务代码

无需请求体。

使用说明

传入 service,比较该服务在不同国家的短信接收转化率。这些数值用于衡量接收质量,不能保证某一条短信一定到达。

请求示例

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

响应

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

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

操作成功

响应示例

{
  "statusCode": 200,
  "data": {
    "service": "opt1",
    "conversions": {
      "UA": 3,
      "KZ": 2,
      "RU": 3
    }
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
dataobject响应数据
data.servicestring服务代码
data.conversionsobject各国家对应的转化率
data.conversions.*integer质量指标,0-3,3 为最佳。
HTTP 400

未收到 API 密钥。

响应示例

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

响应字段

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

相关指南

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

本页内容