其他地方看到的免费.edu域名邮箱


# 莱斯邮件服务API文档

Base URI: `https://laisilsyx.tw.cpolar.io`

不能用？联系`[email protected]`！

## 快速开始

先创建一个邮箱：

```
POST /api/v1/create
Content-Type: application/json

{"tld": "com", "prefix": "Example"}
```

看到：

```json
{ "mail": "[email protected]", "id": "Q9d0VGKGVjKoowwKE5VIeJ4P" }
```

这个id就是接下来操作所必备的标识符。

发送一封测试邮件，然后查看这个邮箱的收件箱：

```
GET /api/v1/mail/Q9d0VGKGVjKoowwKE5VIeJ4P
```

看到：

```
{"mails":[{"sender":"[email protected]","subject":"SendTestEmail.online - Test Email ID: 0932F28627","content":"


Congratulations!


If you are reading this your email address is working.


Test Email ID: 0932F28627


This is not spam or a solicitation. This email was sent to your email address because you, or someone else, requested a test email at SendTestEmail.online. If you did not request this test, someone may have accidentally entered your email address. You can request your email address be blocked here: https://sendtestemail.online/block


The IP address of the requester of this test email is: 193.201.185.155

 

"}]}
```

这里的邮件包含了收件箱中所有邮件的发件人、主题和内容。

这个邮箱是临时有效的，我们可以看到邮箱什么时候过期：

```
GET /api/v1/mail/Q9d0VGKGVjKoowwKE5VIeJ4P/info?prop=mail|expiry
```

看到：

```
{"mail":"[email protected]","expiry":"2026-09-29T06:15:19.000Z"}
```

这里就展示了邮箱过期的精确时间。

好了，测试结束了，再进行一次调用销毁邮箱：

```
DELETE /api/v1/mail/Q9d0VGKGVjKoowwKE5VIeJ4P
```

看到：

```
{}
```

这就是本服务的完整生命周期。

## API参考

### 创建邮箱

**地址:** `/api/v1/create`
**方法:** POST

**请求体参数**

**tld**: 指定邮箱的顶级域名。

**prefix**: 指定邮箱的前缀（`@`）前的部分，不提供时随机。 **(可选)**

**响应体数据**

**mail**: 完整的邮箱地址。

**id**: 操作邮箱的句柄，不应公开。

**可能的错误**

- 422: 不支持的TLD。
- 500: 服务端创建邮箱失败。

### 查看邮箱收件箱

**地址:** `/api/v1/mail/<句柄>`
**方法:** GET

**响应体数据**

**mails[].sender**: 发件人的地址。

**mails[].subject**: 主题行。

**mails[].content**: 原始HTML内容。

**可能的错误**

- 404: 句柄无效或已经过期/被销毁
- 500: 服务端查询收件箱失败。

### 查询邮箱信息

**地址:** `/api/v1/mail/<句柄>/info`
**方法:** GET

**URL参数**

**prop**: 查询的属性列表，用`|`分割，支持`mail`（邮件地址）和`expiry`（过期时间），默认为`mail`。 **(可选)**

**响应体参数**

**mail**: 该句柄对应的邮箱地址。 **(仅在查询了`mail`属性时存在)**

**expiry**: ISO-style的过期时间。 **(仅在查询了`expiry`属性时存在)**

**可能的错误**

- 404: 句柄无效或已经过期/被销毁

### 销毁邮箱

**地址:** `/api/v1/mail/<句柄>`
**方法:** DELETE

**可能的错误**

- 404: 句柄无效或已经过期/被销毁

### 最佳实践

- **√** 用于批量注册网站
- **√** 任务完成后立即销毁
- **√** 保持公平的请求速率
- **×** 用于注册永久性的服务
- **×** 共享或公开句柄
- **×** 大量创建却不使用

### 开发者注意事项

#### 最有效的前缀策略

由于我们聚合了多个上游提供商，它们对前缀的要求各不相同，留空（不指定）是最好的，如果必须指定，最好只包含字母和数字。500错误的原因可能就是前缀不适当。

#### 指定的前缀不保证实际如此

部分提供商不支持自定义前缀，所以请注意，请求的前缀和实际不同，注意使用响应体中的地址。

#### 一般错误处理

当返回非`200`状态码时，**通常**响应体包含一个`error`字段，其指示问题的原因。

#### 404的多种含义

`404`状态码可能代表端点不存在，句柄不存在，句柄已过期或句柄已销毁，我们不能确定具体是何种含义。

#### 可用的TLD

本服务目前支持以下TLD，且持续更新中：

- cyou
- site
- com
- store
- edu

#### 关于参数必填与否

本文中，没有明确标明可选的参数，可视为必填。
最后由小美满编辑于 2026-09-27 22:05
发表回复
