Microsoft-Email-Manager

邮箱账户管理

管理所有已接入的微软邮箱账户

正在加载账户列表...

添加邮箱账户

添加单个微软邮箱账户到系统

接入方案 *

默认使用 IMAP 读取微软邮箱邮件。

邮箱地址 *

请输入有效的微软邮箱地址

刷新令牌 (Refresh Token) *

从 Azure 应用注册流程中获取的刷新令牌，用于 OAuth2 认证

客户端 ID (Client ID) *

Azure 应用程序的客户端标识符

获取步骤

访问 Azure Portal
注册应用程序并配置权限
获取 Client ID 和 Refresh Token
确认应用具备 IMAP.AccessAsUser.All 权限

账户分类（可选）

账户标签（可选）

批量添加邮箱账户

一次性导入多个微软邮箱账户

接入方案 *

当前批量导入将按 IMAP 方案校验和保存这些账户。

批量账户信息

每行格式：邮箱----刷新令牌----客户端ID

提示：每行一个账户，使用四个连字符（`----`）分隔字段；Graph API 支持 邮箱----密码----client_id----令牌，IMAP 兼容旧格式 邮箱----占位密码----刷新令牌----客户端ID

批量导入默认分类（可选）

批量导入默认标签（可选）

注意事项

确保所有账户信息格式正确
建议先测试少量账户再批量导入
导入过程中请不要关闭页面
失败的账户会在结果中显示

分类编辑

统一维护账户分类与快捷标签。中英文都会保存，英文 key 用于 API 请求。

账户分类

例如：销售、运营、客服。创建后可在添加账户和筛选账户时直接选用。

分类中文名

分类英文名

快捷标签

例如：已注册 OpenAI、已注册 XXX。可用于账户管理，也可在邮件详情里一键打标。

标签中文名

标签英文名

API 密钥

创建并管理用于接口调用的 API Key，支持永不过期、固定到期时间、无限请求和固定调用次数。

创建新 API Key

创建后会返回一次完整密钥，请立即保存。后续页面只显示前缀和使用统计，不会再次显示完整值。

名称

到期方式

请求限制

认证方式

接口支持以下任一请求头携带 API Key。

Authorization: Bearer om_your_api_key

X-API-Key: om_your_api_key

每次通过 API Key 的接口请求都会记录一次调用，并从剩余额度中扣除 1 次。

已创建的 API Key

0 个密钥

暂无 API Key，请先创建。

调用记录

按时间倒序

暂无调用记录。

API 接口文档

邮件管理系统的 RESTful API 使用说明

API 基础信息

Base URL

http://localhost:8001

认证方式

推荐请求头

Authorization: Bearer om_your_api_key

兼容请求头

X-API-Key: om_your_api_key

可在后台左侧的“API 密钥”页面创建 Key。每次使用 API Key 调用一次接口，都会扣减一次请求额度并留下调用记录。

响应格式

所有接口均返回 JSON 数据，并通过 HTTP 状态码表示请求结果。

站点设置

主页介绍、管理员后台登录地址、分享页面独立域名不在 API 文档里维护，请到左侧新增的“设置”页面配置。主页介绍会显示在网站根路径，独立分享域名启用后，公开链接会自动替换成指定域名。

调试用 API Key

GET /accounts

获取系统中已添加的全部邮箱账户列表，支持分页与模糊搜索。

请求参数

page integer 页码，从 1 开始，默认值为 1

page_size integer 每页数量，范围 1-100，默认值为 10

email_search string 邮箱账号模糊搜索，可选

tag_search string 标签模糊搜索，可选

category_search string 分类模糊搜索，可匹配分类 key / 中文 / 英文，可选

category_key string 按分类 key 精确过滤，可选

tag_key string 按标签 key 精确过滤，可选

响应示例

{ "total_accounts": 25, "page": 1, "page_size": 10, "total_pages": 3, "accounts": [ { "email_id": "example@outlook.com", "client_id": "your-client-id", "status": "active", "category_key": "registered_customer", "category": { "key": "registered_customer", "name_zh": "已注册客户", "name_en": "Registered Customer" }, "tag_keys": ["registered_openai", "vip"], "tag_details": [ { "key": "registered_openai", "name_zh": "已注册 OpenAI", "name_en": "Registered OpenAI" } ] } ] }

响应结果

GET /classifications

获取当前可用的分类与标签配置，前端可用它生成下拉框、快捷标记和筛选器。

响应示例

{ "categories": [ { "key": "registered_customer", "name_zh": "已注册客户", "name_en": "Registered Customer" } ], "tags": [ { "key": "registered_openai", "name_zh": "已注册 OpenAI", "name_en": "Registered OpenAI" } ] }

POST /classifications/categories

创建账户分类。必须同时传中文名和英文名，系统会把英文名规范化为 API key。

请求体

{ "name_zh": "已注册客户", "name_en": "registered_customer" }

POST /classifications/tags

创建快捷标签。标签同时可用于账户和邮件详情中的一键打标。

请求体

{ "name_zh": "已注册 OpenAI", "name_en": "registered_openai" }

PUT /accounts/{email_id}/classification

更新指定账户的分类与标签。分类可为空，标签可多选。

请求体

{ "category_key": "registered_customer", "tag_keys": ["registered_openai", "vip"] }

GET /emails/{email_id}

获取指定邮箱的邮件列表，支持分页和筛选。

路径参数

email_id string 邮箱地址，需要进行 URL 编码

查询参数

folder string 邮件文件夹（all、inbox、junk），默认值为 all

page integer 页码，从 1 开始，默认值为 1

page_size integer 每页数量，范围 1-500，默认值为 100

refresh boolean 是否强制刷新缓存，默认值为 false

请求示例

GET /emails/example%40outlook.com?folder=inbox&page=1&page_size=20&refresh=true

响应示例

{ "email_id": "example@outlook.com", "folder_view": "inbox", "page": 1, "page_size": 20, "total_emails": 150, "emails": [ { "message_id": "INBOX-1", "folder": "INBOX", "subject": "邮件主题", "from_email": "sender@example.com", "date": "2024-01-01T12:00:00Z", "is_read": false, "has_attachments": true, "sender_initial": "S", "tag_keys": ["registered_openai"], "tag_details": [ { "key": "registered_openai", "name_zh": "已注册 OpenAI", "name_en": "Registered OpenAI" } ] } ] }

响应结果

GET /emails/{email_id}/{message_id}

获取指定邮件的详细内容，包括正文。

路径参数

email_id string 邮箱地址，需要进行 URL 编码

message_id string 邮件 ID，格式为 {folder}-{id}

请求示例

GET /emails/example%40outlook.com/INBOX-1

响应示例

{ "message_id": "INBOX-1", "subject": "邮件主题", "from_email": "sender@example.com", "to_email": "example@outlook.com", "date": "2024-01-01T12:00:00Z", "tag_keys": ["registered_openai"], "body_plain": "纯文本邮件内容", "body_html": "<html><body>HTML 邮件内容</body></html>" }

响应结果

PUT /emails/{email_id}/{message_id}/tags

给指定邮件批量设置标签。前端快捷标记按钮调用的就是这个接口。

请求体

{ "tag_keys": ["registered_openai", "follow_up"] }

响应示例

{ "email_id": "example@outlook.com", "message_id": "INBOX-1", "message": "Email tags updated successfully.", "tag_keys": ["registered_openai", "follow_up"] }

自定义请求参数

右侧工作台支持可视化选择接口、修改路径参数、查询参数和请求体，并实时预览最终请求数据。

接口选择

请选择一个接口开始调试。

GET 实时预览

/accounts

路径参数

查询参数

请求体

请求预览

响应结果

未发送

选择参数后即可发送请求。

站点设置

配置网站主页介绍、管理员入口地址、公开分享独立域名，以及 Cloudflare Turnstile 验证。

主页与后台

网站主页标题

显示在根路径 / 的网站主页上。

网站主页介绍

管理员后台登录地址

必须是站内路径，例如 /admin 或 /safe-panel。修改后后台会立即切换到新地址。

当前管理员入口

公开分享域名

分享页面域名

只填写域名，支持端口，例如 share.example.com 或 127.0.0.1:9000。

效果说明

1. 邮件公开设置里的链接会自动替换成这个域名。
2. 指定分享域名上只允许公开分享页面和它依赖的静态资源访问。
3. 这样可以把后台入口和公开页面拆开，减少主站暴露面。

Cloudflare Turnstile

Site Key

Secret Key

启用范围

为了减少页面跳动，登录页和公开密码页都预留了固定高度的验证区域。请确保你的 Turnstile 小组件已允许管理员域名和分享域名访问。

当前账户

当前账户 / 快速切换 / 复制 / 快捷绑定

最后更新：-

邮件总数

未读邮件

今日邮件

带附件

正在加载邮件...