服务与价格

发送 GET 请求后，即使 HTTP 为 200，也请检查 status：1 成功，0 失败，创建租赁时的 2 表示暂无邮箱。错误详情可能在 msg、errormsg 和 errorid 中。

身份验证复制链接

调用此方法无需 API 密钥。

参数复制链接

使用说明复制链接

查看服务、日价和邮箱余量。传入供应商的 pcode 可按供应商筛选，省略则合计已启用供应商。用服务的 scode 创建租赁。

价格单位为 USD。租期至少 30 天时适用 months_discount。仅 Gmail 支持别名。切换供应商后，请刷新余量。

请求示例复制链接

运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。

设置 SMSPVA_EMAIL_PCODE 选择当前供应商；未设置或空值时完全省略 pcode。请使用实时列表中的代码。

provider_args=()
if [ -n "${SMSPVA_EMAIL_PCODE:-}" ]; then provider_args=(--data-urlencode "pcode=$SMSPVA_EMAIL_PCODE"); fi
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
  --data-urlencode "method=get_data" \
  "${provider_args[@]}"

响应复制链接

请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。

HTTP 200复制链接

HTTP 为 200 时仍需检查 status；示例数值仅供参考。

application/json

成功响应示例

{
  "status": 1,
  "data": [
    {
      "count": 40,
      "scode": "twitter",
      "sname": "Twitter",
      "price": 0.1,
      "alias_price": 0.25,
      "icon": "/templates/SMSv1EN/images/ico/twitter.png",
      "months_discount": 20
    }
  ]
}

错误

{
  "status": 0,
  "msg": "Provider not found"
}

成功

必填： status, data

错误

部分错误含 errorid 和 errormsg，其他错误仅有 msg。请检查响应中提供的全部错误字段。

相关指南复制链接

• Private Email Rental API
• 供应商与服务
• 邮箱租赁流程
• 错误
• OpenAPI 定义