SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

当前订单

列出当前激活订单及其 ID。

SMSPVA API
GEThttps://api.smspva.com/activation/orders

身份验证

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

参数

无需路径参数、查询参数或请求体。

使用说明

查看当前激活订单。返回的 orderId 可用于接收短信及其他订单管理操作。

请求示例

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

响应

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

HTTP说明
200操作成功
501服务器未能处理请求。
503服务器负载过高，请稍后再试。
HTTP 200

操作成功

响应示例

{
  "statusCode": 200,
  "data": {
    "orders": [
      {
        "orderId": 123456,
        "phoneNumber": 987654321,
        "countryCode": "+7",
        "orderExpireIn": 599,
        "service": "opt0",
        "country": "UK",
        "status": "PENDING_SMS|SMS_READY|PENDING_PAYMENT",
        "sms": {
          "code": "1234",
          "fullText": "Your service Activation code is 1234. Don't tell it anybody"
        }
      }
    ]
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
dataobject响应数据
data.ordersarray<object>响应数据
data.orders[].orderIdinteger订单 ID
data.orders[].phoneNumberinteger不含国家区号的电话号码
data.orders[].countryCodestring国家电话区号。
data.orders[].orderExpireIninteger距订单到期的秒数
data.orders[].servicestring服务代码 服务列表
data.orders[].countrystring符合 ITU-T E.123 和 E.164 的国家代码。 国家列表
data.orders[].statusstring短信状态。
data.orders[].smsobject短信状态。
data.orders[].sms.codestring短信中的服务激活码。
data.orders[].sms.fullTextstring完整短信文本。
HTTP 501

服务器未能处理请求。

响应示例

{
  "statusCode": 501,
  "error": {
    "type": "SERVER_FAIL",
    "description": "Server failed to process request"
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
errorobject响应数据
error.typestring错误类型
error.descriptionstring错误说明
HTTP 503

服务器负载过高，请稍后再试。

响应示例

{
  "statusCode": 503,
  "error": {
    "type": "SERVER_BUSY",
    "description": "Server overload, try later."
  }
}

响应字段

名称类型说明
statusCodeinteger结果状态码
errorobject响应数据
error.typestring错误类型
error.descriptionstring错误说明

相关指南

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

接收短信

获取短信、来电显示或语音结果；HTTP 202 表示仍在等待。

号码状态

检查此前在同一服务使用过的号码。

本页内容

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