Private Email Rental
SMSPVA / DOCUMENTATION
邮件正文
GET /api/rent_email.php?method=get_mail_body
SMSPVA API
发送 GET 请求后，即使 HTTP 为 200，也请检查 status：1 成功，0 失败，创建租赁时的 2 表示暂无邮箱。错误详情可能在 msg、errormsg 和 errorid 中。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
apikey | query | string | 是 | SMSPVA_API_KEY | 账户 API 密钥。读取邮件及管理租赁需要使用订单所属账户的密钥。 |
method | query | string | 是 | "get_mail_body" | 要调用的方法。 |
orderid | query | integer | 是 | 123456 | 按所调用方法，从 Create Order、Active Orders 或 Archived Orders 获取订单 ID。 |
emailid | query | integer | 是 | 6 | 邮件列表接口返回的邮件 ID。 |
使用说明
用邮件列表或别名邮件中的 emailid 读取完整内容，同时传入父租赁订单的 orderid。
body 可能包含发件人的 HTML。请将其视为不可信内容，在应用中显示前进行清理。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
SMSPVA_EMAIL_ORDER_ID:orderid.SMSPVA_EMAIL_MESSAGE_ID:emailid.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_EMAIL_ORDER_ID:?Set SMSPVA_EMAIL_ORDER_ID}"
: "${SMSPVA_EMAIL_MESSAGE_ID:?Set SMSPVA_EMAIL_MESSAGE_ID}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
--data-urlencode "method=get_mail_body" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "orderid=$SMSPVA_EMAIL_ORDER_ID" \
--data-urlencode "emailid=$SMSPVA_EMAIL_MESSAGE_ID"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
HTTP 为 200 时仍需检查 status；示例数值仅供参考。
application/json
成功响应示例
{
"status": 1,
"data": {
"id": 6,
"sender": "[email protected]",
"subject": "Verification code",
"body": "<p>Your code: 12345</p>",
"addedAt": "2026-10-22T10:00:00.000Z"
}
}错误
{
"status": 0,
"msg": "Incorrect apikey"
}成功
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | (enum: [1]) |
data | object | |
data.id | integer | 邮件 ID。 |
data.sender | string | 发件人地址。 |
data.subject | string | 邮件主题。 |
data.body | string | 邮件正文，可能包含 HTML。显示前请按不可信内容处理。 |
data.addedAt | string | 邮件时间。 (format: "date-time") |
必填： status, data
错误
部分错误含 errorid 和 errormsg，其他错误仅有 msg。请检查响应中提供的全部错误字段。
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | (enum: [0]) |
errorid | integer | 可选的结构化错误代码。 |
errormsg | string | 可选的错误说明。 |
msg | string | 错误信息。 |