SMSPVAdevelopers
Private Email Rental
SMSPVA / DOCUMENTATION

供应商

GET /api/rent_email.php?method=get_providers

SMSPVA API
GEThttps://smspva.com/api/rent_email.php?method=get_providers

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

身份验证

调用此方法无需 API 密钥。

参数

名称位置类型必填示例说明
methodquerystring是"get_providers"要调用的方法。

使用说明

获取已启用的邮箱供应商,用其 pcode 构建选择列表。请定期刷新,避免固定保存代码。供应商已启用,并不代表每个服务都有可用邮箱。

在查询服务及价格、余量和创建订单时,请使用同一 pcode。

请求示例

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

curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
  --data-urlencode "method=get_providers"

响应

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

HTTP 200

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

application/json

成功响应示例

{
  "status": 1,
  "data": [
    {
      "id": 2,
      "pcode": "gmailcom",
      "name": "Gmail"
    },
    {
      "id": 6,
      "pcode": "outlookcom",
      "name": "Microsoft Outlook"
    }
  ]
}

错误

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

成功

名称类型说明
statusinteger(enum: [1])
dataarray<object>
data[].idinteger供应商 ID。
data[].pcodestring用于筛选和创建订单的供应商代码。
data[].namestring显示名称。

必填: status, data

错误

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

名称类型说明
statusinteger(enum: [0])
erroridinteger可选的结构化错误代码。
errormsgstring可选的错误说明。
msgstring错误信息。

相关指南

本页内容