Linux DO 邮箱

Linux DO Mail

加密连接 Linux DO Mail，按需读取 INBOX 并通过官方 SMTP 发件。

Connect Linux DO Mail with encrypted credentials, read INBOX on demand, and send through official SMTP.

本分类共 10 个端点。返回 完整 API 索引 或 API 架构与安全说明。

GET /api/linux-do-mail/account

读取 Linux DO Mail 连接 / Read the Linux DO Mail connection

返回功能状态和当前用户的脱敏账号信息，不返回密码或认证令牌。

Return feature status and sanitized account metadata without returning the password or authentication token.

cURL 示例

curl --request GET \
  --url "https://mail.example.com/api/linux-do-mail/account" \
  --header "Authorization: Bearer om_at_..."

POST /api/linux-do-mail/account

连接 Linux DO Mail / Connect Linux DO Mail

使用完整邮箱用户名和密码或认证令牌验证 IMAP，再加密保存凭据。

Validate IMAP with the full mailbox username and a password or authentication token, then encrypt the credential.

注意：官方建议使用可撤销的专用认证令牌，不要提交邮箱主密码。

Note: Linux DO recommends a revocable dedicated authentication token instead of the mailbox master password.

cURL 示例

curl --request POST \
  --url "https://mail.example.com/api/linux-do-mail/account" \
  --header "Authorization: Bearer om_at_..." \
  --header "Content-Type: application/json" \
  --data '{
  "username": "member@linux.do",
  "password": "authentication-token"
}'

DELETE /api/linux-do-mail/account

断开 Linux DO Mail / Disconnect Linux DO Mail

删除当前用户的账号记录和凭据密文，不修改服务器端邮箱。

Delete the current user’s account record and encrypted credential without changing the server-side mailbox.

cURL 示例

curl --request DELETE \
  --url "https://mail.example.com/api/linux-do-mail/account" \
  --header "Authorization: Bearer om_at_..."

POST /api/linux-do-mail/account/verify

验证 Linux DO Mail 凭据 / Verify Linux DO Mail credentials

重新登录 IMAP 并执行只读 EXAMINE INBOX。

Sign in to IMAP again and run the read-only EXAMINE INBOX command.

cURL 示例

curl --request POST \
  --url "https://mail.example.com/api/linux-do-mail/account/verify" \
  --header "Authorization: Bearer om_at_..."

PUT /api/linux-do-mail/account/credential

更新 Linux DO Mail 凭据 / Update the Linux DO Mail credential

先验证新密码或认证令牌，再替换已保存的密文；验证失败时保留原凭据。

Validate the new password or authentication token before replacing the saved ciphertext; keep the existing credential when validation fails.

注意：响应不会包含新旧凭据。

Note: The response never contains the old or new credential.

cURL 示例

curl --request PUT \
  --url "https://mail.example.com/api/linux-do-mail/account/credential" \
  --header "Authorization: Bearer om_at_..." \
  --header "Content-Type: application/json" \
  --data '{
  "password": "new-authentication-token"
}'

POST /api/linux-do-mail/messages

发送 Linux DO Mail 邮件 / Send a Linux DO Mail message

使用已连接账号通过 SMTP 465 异步发送邮件，并复用 OmniMail 的幂等、限速、队列和失败保护。

Send asynchronously through SMTP 465 with the connected account while reusing OmniMail idempotency, rate limits, queueing, and failure protection.

注意：From 固定为当前已验证的 Linux DO Mail 地址，不能由请求覆盖。

Note: From is fixed to the currently verified Linux DO Mail address and cannot be overridden by the request.

注意：当前额外执行每日 50 封硬上限；相同 idempotencyKey 不会重复入队。

Note: A hard cap of 50 messages per day is currently enforced; the same idempotencyKey is not queued twice.

cURL 示例

curl --request POST \
  --url "https://mail.example.com/api/linux-do-mail/messages" \
  --header "Authorization: Bearer om_at_..." \
  --header "Content-Type: application/json" \
  --data '{
  "to": "recipient@example.net",
  "subject": "Hello",
  "text": "Message body",
  "idempotencyKey": "request_12345678"
}'

GET /api/linux-do-mail/inbox

读取 Linux DO Mail 最近来信 / List recent Linux DO Mail messages

通过 IMAP 读取 INBOX 最近 20 封邮件，或在服务器上搜索主题、联系人与正文。

Read the 20 most recent INBOX messages over IMAP, or search subjects, contacts, and body text on the server.

cURL 示例

curl --request GET \
  --url "https://mail.example.com/api/linux-do-mail/inbox?q=release" \
  --header "Authorization: Bearer om_at_..."

GET /api/linux-do-mail/inbox/{uid}

读取 Linux DO Mail 正文 / Read a Linux DO Mail message

通过数字 IMAP UID 获取受大小限制的邮件正文，并尝试同步标记已读。

Read a size-limited message by numeric IMAP UID and attempt to synchronize its Seen flag.

注意：已读写入失败不阻断正文响应；响应中的 isRead 表示服务器状态或本次成功写入的结果。

Note: A Seen write failure does not block the body response; isRead reflects the server state or a successful update in this request.

cURL 示例

curl --request GET \
  --url "https://mail.example.com/api/linux-do-mail/inbox/123" \
  --header "Authorization: Bearer om_at_..."

GET /api/linux-do-mail/sent

读取 Linux DO Mail 发件记录 / List sent Linux DO Mail messages

读取或搜索当前账号最近 20 条 OmniMail 发件记录及排队、成功或失败状态。

List or search the 20 most recent OmniMail outbound records for the current account with queued, sent, or failed status.

cURL 示例

curl --request GET \
  --url "https://mail.example.com/api/linux-do-mail/sent?q=invoice" \
  --header "Authorization: Bearer om_at_..."

GET /api/linux-do-mail/sent/{id}

读取 Linux DO Mail 发件正文 / Read a sent Linux DO Mail message

从受当前用户约束的 D1 和 R2 记录读取发件正文与投递状态。

Read outbound content and delivery state from user-scoped D1 and R2 records.

cURL 示例

curl --request GET \
  --url "https://mail.example.com/api/linux-do-mail/sent/resource_id" \
  --header "Authorization: Bearer om_at_..."