按运营商获取号码

此请求可能修改订单或产生费用。 示例不会自动重试。即使使用 GET，读取新收到的短信也可能触发计费。

身份验证复制链接

参数复制链接

无需请求体。

使用说明复制链接

为所选 country 和 service 指定 operator 申请号码。支持自营及外部供应商运营商代码。

代码见基础数据。下单前请检查价格、余量及消息类型设置，也可比较运营商价格和各国价格。

保存 data.orderId，用于接收短信及管理订单。用 data.orderExpireIn 计算到期时间。请求超时后，先查当前订单再申请新号码：上一次请求可能已经创建订单。

有效 operator 代码见运营商。例如 DonorAlpha_UK 的外部运营商通过第三方提供号码，请求格式相同，但号码稳定性可能不及 SMSPVA 自营的真实 SIM 卡。

请求示例复制链接

运行环境及配置. 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/number/BD/opt20/Grameenphone_BD?voice=0" \
  --header "apikey: $SMSPVA_API_KEY"

响应复制链接

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

{
  "statusCode": 200,
  "data": {
    "orderId": 123456,
    "phoneNumber": 9876544321,
    "countryCode": "BD",
    "orderExpireIn": 600
  }
}

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

相关指南复制链接

• Activation V2
• 基础数据
• 激活流程
• 错误与限制
• 下载 OpenAPI

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