Private Email Rental
SMSPVA / DOCUMENTATION
购买别名访问权
GET /api/rent_email.php?method=buy_alias
SMSPVA API
发送 GET 请求后，即使 HTTP 为 200，也请检查 status：1 成功，0 失败，创建租赁时的 2 表示暂无邮箱。错误详情可能在 msg、errormsg 和 errorid 中。
此请求可能修改租赁订单或产生费用。响应丢失后，先查询订单及历史，再决定是否重试：更改可能已经生效。示例不会自动重试。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
apikey | query | string | 是 | SMSPVA_API_KEY | 账户 API 密钥。读取邮件及管理租赁需要使用订单所属账户的密钥。 |
method | query | string | 是 | "buy_alias" | 要调用的方法。 |
orderid | query | integer | 是 | 123456 | 按所调用方法，从 Create Order、Active Orders 或 Archived Orders 获取订单 ID。 |
aliasid | query | integer | 是 | 88 | Active Orders 的 aliases 中已有的别名 ID；orderid 必须是父订单 ID。 |
使用说明
购买已有 Gmail 别名的访问权。在有效订单的 aliases 中获取 aliasid，并将父订单 ID 作为 orderid。Outlook 不支持别名。
本请求只购买订单中已有别名的访问权，不会创建新别名，也没有公开的别名生成接口。购买后可查询别名邮件。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
SMSPVA_EMAIL_ORDER_ID:orderid.SMSPVA_EMAIL_ALIAS_ID:aliasid.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_EMAIL_ORDER_ID:?Set SMSPVA_EMAIL_ORDER_ID}"
: "${SMSPVA_EMAIL_ALIAS_ID:?Set SMSPVA_EMAIL_ALIAS_ID}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
--data-urlencode "method=buy_alias" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "orderid=$SMSPVA_EMAIL_ORDER_ID" \
--data-urlencode "aliasid=$SMSPVA_EMAIL_ALIAS_ID"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
HTTP 为 200 时仍需检查 status；示例数值仅供参考。
application/json
成功响应示例
{
"status": 1,
"data": {
"alias": "[email protected]"
}
}错误
{
"status": 0,
"msg": "Incorrect apikey"
}成功
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | (enum: [1]) |
data | object | |
data.alias | string | 别名地址。 |
必填： status, data
错误
部分错误含 errorid 和 errormsg，其他错误仅有 msg。请检查响应中提供的全部错误字段。
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | (enum: [0]) |
errorid | integer | 可选的结构化错误代码。 |
errormsg | string | 可选的错误说明。 |
msg | string | 错误信息。 |