# Monk Mail

> 免费临时邮箱：一秒拿到一个 @monk.party / @mastersgo.cc / @ssgoo.net 地址，用来收注册邮件和验证码。只能收信，不能发信。后端是开源项目 cloudflare_temp_email（https://github.com/dreamhunter2333/cloudflare_temp_email），本站接口与它一致。

Base URL: https://mail.monk.party

## 用法（3 步）

1. 看可用域名：`GET /open_api/settings` → `domains`、`prefix`（地址会自动加这个前缀，目前是 `tmp`）、`maxAddressLen`。
2. 建地址：`POST /api/new_address`，JSON `{"name": "myagent01", "domain": "monk.party"}`。
   - `name` 只能用小写字母和数字，留空会随机生成。
   - 返回 `{"jwt": "...", "address": "tmpmyagent01@monk.party", "address_id": 1}`。**保存好 jwt**，它就是这个邮箱的钥匙。
   - 名字被占用会返回 400，换一个名字重试。
3. 收信：`GET /api/parsed_mails?limit=20&offset=0`，请求头 `Authorization: Bearer <jwt>`。
   - 返回 `{"results": [{"id", "created_at", "sender", "subject", "text", "html", "attachments": [{"filename","mimeType","size"}]}], "count": N}`，最新的在前。
   - `created_at` 是 UTC 时间，格式 `YYYY-MM-DD HH:MM:SS`。
   - 等验证码时每 5–10 秒轮询一次，别更频繁。

## 其他接口（都要 `Authorization: Bearer <jwt>`）

- `GET /api/parsed_mail/{id}`：单封邮件（解析后）
- `GET /api/mail/{id}`：单封邮件原文，`{"raw": "<MIME>"}`，附件在原文里
- `DELETE /api/mails/{id}`：删一封
- `DELETE /api/clear_inbox`：清空收件箱
- `DELETE /api/delete_address`：彻底删除这个地址
- `GET /api/settings`：当前地址信息

## 示例

```bash
JWT=$(curl -s -X POST https://mail.monk.party/api/new_address \
  -H 'content-type: application/json' -d '{"name":"","domain":"monk.party"}' | jq -r .jwt)
curl -s https://mail.monk.party/api/parsed_mails?limit=5\&offset=0 -H "Authorization: Bearer $JWT" \
  | jq '.results[] | {subject, sender, text}'
```

## 注意

- 临时邮箱，不保证长期保存，别用来收重要账号的信。
- 网页版把 jwt 存在浏览器 localStorage（键 `jwt` 和 `LocalAddressCache`），和旧版界面通用。
- 旧版完整界面（含管理后台）：https://mail-classic.monk.party