Private Email Rental
SMSPVA / DOCUMENTATION
延长租赁
GET /api/rent_email.php?method=prolong_order
SMSPVA API
发送 GET 请求后，即使 HTTP 为 200，也请检查 status：1 成功，0 失败，创建租赁时的 2 表示暂无邮箱。错误详情可能在 msg、errormsg 和 errorid 中。
此请求可能修改租赁订单或产生费用。响应丢失后，先查询订单及历史，再决定是否重试：更改可能已经生效。示例不会自动重试。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
apikey | query | string | 是 | SMSPVA_API_KEY | 账户 API 密钥。读取邮件及管理租赁需要使用订单所属账户的密钥。 |
method | query | string | 是 | "prolong_order" | 要调用的方法。 |
orderid | query | integer | 是 | 123456 | 按所调用方法，从 Create Order、Active Orders 或 Archived Orders 获取订单 ID。 |
dtype | query | string | 是 | "week" | 租赁单位：day = 1 天，week = 7 天，month = 30 天。 |
dcount | query | integer | 是 | 1 | 租赁周期数，必须为正数。 |
使用说明
用有效订单中的 ID 延长租赁，费用从余额扣除。dcount 必须为正数；day、week、month 每单位分别为 1、7、30 天。
若服务配置了折扣，延期至少 30 天时适用。成功后请刷新有效订单查看新的到期时间，本响应不包含该时间。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
SMSPVA_EMAIL_ORDER_ID:orderid.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_EMAIL_ORDER_ID:?Set SMSPVA_EMAIL_ORDER_ID}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
--data-urlencode "method=prolong_order" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "orderid=$SMSPVA_EMAIL_ORDER_ID" \
--data-urlencode "dtype=${SMSPVA_EMAIL_DTYPE:-week}" \
--data-urlencode "dcount=${SMSPVA_EMAIL_DCOUNT:-1}"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
HTTP 为 200 时仍需检查 status；示例数值仅供参考。
application/json
成功响应示例
{
"status": 1,
"data": {
"id": 123456,
"email": "[email protected]",
"service": "Twitter"
}
}错误
{
"status": 0,
"msg": "Incorrect apikey"
}成功
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | (enum: [1]) |
data | object | |
data.id | integer | 订单 ID。 |
data.email | string | 邮箱地址。 |
data.service | string | 服务显示名称，并非服务代码。 |
必填： status, data
错误
部分错误含 errorid 和 errormsg，其他错误仅有 msg。请检查响应中提供的全部错误字段。
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | (enum: [0]) |
errorid | integer | 可选的结构化错误代码。 |
errormsg | string | 可选的错误说明。 |
msg | string | 错误信息。 |