邮箱余量

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

身份验证复制链接

调用此方法无需 API 密钥。

参数复制链接

使用说明复制链接

按服务查询邮箱余量。传入 pcode 查询一个供应商，省略则合计全部已启用供应商。用 scode 关联条目；缺少某服务表示余量为零，data 为空数组表示没有库存。

余量最多缓存 15 秒，查询不会预留邮箱。切换供应商时，应替换旧数据，并忽略之前选择对应的迟到响应。创建订单时请使用同一供应商。

请求示例复制链接

运行环境及依赖. 示例会对查询参数编码，最多等待 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_count" \
  "${provider_args[@]}"

响应复制链接

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

HTTP 200复制链接

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

application/json

成功响应示例

{
  "status": 1,
  "data": [
    {
      "count": 40,
      "scode": "twitter"
    },
    {
      "count": 38,
      "scode": "fb"
    }
  ]
}

错误

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

Empty result

{
  "status": 1,
  "data": []
}

成功

必填： status, data

错误

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

相关指南复制链接

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