API 调用

所有 API 都需要请求头 Authorization: Bearer YOUR_TOKEN。读取使用 READ_TOKEN，导入、标签和移除使用 ADMIN_TOKEN。

邮箱列表

GET /api/v1/accounts?limit=50&offset=0&q=关键词

批量导入

POST /api/v1/accounts/import
Content-Type: application/json
{"text":"邮箱----密码----应用ID----刷新令牌\n…","label":"测试账号"}

每次最多 500 个。重复账号跳过；密码不保存，刷新令牌加密保存。

读取邮件

GET /api/v1/accounts/ACCOUNT_ID/messages?folder=inbox
GET /api/v1/accounts/ACCOUNT_ID/messages?folder=junkemail
GET /api/v1/accounts/ACCOUNT_ID/messages/MESSAGE_ID

列表返回 items 和 next_cursor。将 next_cursor URL 编码后传入 cursor 参数读取下一页。邮件 ID 也须 URL 编码。读取不改变已读状态。

管理

PATCH /api/v1/accounts/ACCOUNT_ID
{"label":"新标签"}

POST /api/v1/accounts/delete
{"ids":["ACCOUNT_ID"]}

命令行示例

curl "$BASE_URL/api/v1/accounts" \
  -H "Authorization: Bearer $READ_TOKEN"

错误处理

401：密钥错误；403：权限不足；409：邮箱正被其他请求使用；422：授权需检查；429：微软限流；503：微软服务不可用。409 / 429 / 503 请按 Retry-After 等待，勿高频重试。

本服务只读取用户提供且已授权的邮箱。不提供发送邮件或自动注册功能。READ_TOKEN 可以读取全部已导入邮箱，请仅交给可信客户端。