Activation V2
SMSPVA / API REFERENCE
接收质量指标
比较同一服务在不同国家的短信接收质量指标。
SMSPVA API
身份验证
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
apikey | header | string | 是 | 你的 API 密钥 |
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
service | path | string | 是 | 服务代码 |
无需请求体。
使用说明
传入 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
}
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 结果状态码 |
data | object | 响应数据 |
data.service | string | 服务代码 |
data.conversions | object | 各国家对应的转化率 |
data.conversions.* | integer | 质量指标,0-3,3 为最佳。 |
HTTP 400
未收到 API 密钥。
响应示例
{
"statusCode": 400,
"error": {
"type": "APIKEY_NOT_SET",
"description": "No ApiKey found"
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 结果状态码 |
error | object | 错误详情 |
error.type | string | 错误类型 |
error.description | string | 错误说明 |
相关指南
修改订单的请求发生网络故障时,先检查订单状态,再决定是否重试。