邮局 API 使用说明

📌

请登录 https://mail.998816.xyz 然后点击头像查看 API Key

1. API Key 使用说明

部分接口需要传入 API Key 才能访问。

每个域名对应一个唯一的 API Key，在租用服务时已提供。

在请求时，请在 HTTP Header 中添加：

2. 调用频率限制

为了保证服务稳定，部分 API Key 的调用频率限制为：30 次 / 分钟

请合理安排请求，避免频繁调用接口。

超过限制时，API 将返回 429 Too Many Requests 错误。

以下是不受频率限制的API列表

获取最新一封邮件

3. 常见问题

1.

API Key 无效或未提供

返回 HTTP 401 Unauthorized。

请检查是否在 Header 中正确传入 X-API-KEY。

2.

请求频率过高

返回 HTTP 429 Too Many Requests。

请按照频率限制（30 次/分钟）合理调用。

3.

缺少请求参数或参数不符合要求

返回 HTTP 422 Unprocessable Entity。

请检查请求参数，并配合错误提示排除故障。