AI 友好文档
通用信息
基础 URL: https://api.duckmail.sbs
认证
Bearer Token
公共域名查询和创建公共临时邮箱可匿名调用；创建成功后须另外调用 POST /token 获取收件 Token。读取邮箱使用 Bearer Token，托管邮箱也可由所有者使用 API Key 换取收件 Token。
API 密钥
同一个 API 密钥可获取本人全部私有域名、创建私有域名邮箱，以及访问和管理全部托管邮箱。密钥以 `dk_` 开头。列出、导入、管理 Microsoft 托管邮箱时必须携带。GET /domains 和创建临时邮箱时，仅在使用私有域名才需要。您可以访问 https://domain.duckmail.sbs 获取您的 API 密钥。
限流与重试
当前直接调用 API 的每 IP 限额：携带有效 Token/API Key 为 1000 请求/秒；未认证请求为 1000 请求/秒，其中创建账号为 200 请求/秒。持续无效请求可能被临时限制。
遇到 429，请按 Retry-After 指定的秒数等待后重试。建议每 2 秒轮询一次，避免重复请求。
错误处理
400/403/422：检查参数或权限；401：检查登录状态；404/410：刷新列表；424：更新 Microsoft 授权。