Activation V2
SMSPVA / API REFERENCE
号码状态
检查此前在同一服务使用过的号码。
SMSPVA API
身份验证
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
apikey | header | string | 是 | 你的 API 密钥 |
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
number | path | string | 是 | 不含国家电话区号的号码。 (pattern: "^[0-9]{5,}$") |
service | path | string | 是 | 服务代码，全部代码可通过 servicesprices 查询。 |
无需请求体。
使用说明
检查曾用号码是否仍能接收同一 service 的短信。仅适用于你已用该号码接收过该服务短信的情况。传入 number 时去掉国家电话区号。
请求示例
运行环境及配置. cURL 使用 POSIX shell。JavaScript 示例也可用于 Node.js TypeScript 项目。Java 使用标准 HTTP 客户端并输出原始 JSON；请使用应用的 JSON 库读取响应字段。
SMSPVA_NUMBER: number (必填).
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_NUMBER:?Set SMSPVA_NUMBER to your number}"
curl --fail-with-body --max-time 30 --request GET \
--url "https://api.smspva.com/activation/numberstatus/${SMSPVA_NUMBER}/opt0" \
--header "apikey: $SMSPVA_API_KEY"响应
下方示例用于说明响应格式。价格、余量和账户数据仅为示例，实际数值请以 API 响应为准。
| HTTP | 说明 |
|---|---|
| 200 | 操作成功 |
| 405 | 号码格式不正确 |
| 406 | 订单 ID 格式不正确或未找到。 |
| 500 | 服务器内部错误，说明可能包含诊断详情。 |
| 501 | 服务器未能处理请求。 |
| 502 | 未找到号码。 |
| 503 | 服务器负载过高，请稍后再试。 |
| 504 | av2.resp.504.desc：原始文档未提供此响应的完整说明。 |
HTTP 200
操作成功
响应示例
{
"statusCode": 200,
"data": {
"number": "98765432",
"orderId": 123456,
"countryCode": "+7"
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 结果状态码 |
data | object | 响应数据 |
data.number | string | 不含国家电话区号的号码。 |
data.orderId | integer | 你之前使用此号码和服务的订单 ID。 |
data.countryCode | string | 国家电话区号。 |
HTTP 405
号码格式不正确
响应示例
{
"statusCode": 405,
"error": {
"type": "INVALID_NUMBER_FORMAT",
"description": "Number should be integer with more than 5 digits"
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 结果状态码 |
error | object | 响应数据 |
error.type | string | 错误类型 |
error.description | string | 错误说明 |
HTTP 406
订单 ID 格式不正确或未找到。
响应示例
{
"statusCode": 406,
"error": {
"type": "ORDER_NOT_FOUND",
"description": "Order not found."
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 结果状态码 |
error | object | 错误详情 |
error.type | string | 错误类型 |
error.description | string | 错误说明 |
HTTP 500
服务器内部错误，说明可能包含诊断详情。
响应示例
{
"statusCode": 500,
"error": {
"type": "SERVER_ERROR",
"description": "An internal error has occurred while processing your request."
}
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
statusCode | integer | |
error | object | |
error.type | string | |
error.description | string |
HTTP 501
服务器未能处理请求。
HTTP 502
未找到号码。
HTTP 503
服务器负载过高，请稍后再试。
HTTP 504
av2.resp.504.desc：原始文档未提供此响应的完整说明。
相关指南
修改订单的请求发生网络故障时，先检查订单状态，再决定是否重试。