针对 Run2Mail 构建

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

API 密钥验证核心端点错误代码

API 密钥

从您的仪表板生成开发人员 API 密钥。每个密钥仅完整显示一次，然后存储为安全散列以供将来验证。

从您登录的仪表板创建密钥。
将密钥保密并将其存储在您自己的秘密管理器中。
每当设备、脚本或队友不再需要访问权限时，即可撤销旧密钥。

验证

在授权标头中为每个受保护的请求使用承载令牌。

Authorization: Bearer YOUR_API_KEY

如果密钥无效、已撤销或丢失，API 将返回身份验证错误。

核心端点

最常见的工作流程是：检查经过身份验证的用户，创建收件箱，然后从该收件箱获取消息。

检查当前账户

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

创建收件箱

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

获取收件箱消息

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

JSON 响应示例

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

速率限制

Run2Mail 应用基于计划的请求限制和每日收件箱创建限制来保护服务并保持 API 访问稳定。

每分钟的速率限制取决于您的活动计划。
电子邮件创建限制与基本读取调用分开跟踪。
记录使用情况以便在管理分析仪表板内可见。

错误代码

401: API 凭据缺失或无效。
403: 访问被阻止、受限或不允许该请求。
429: 请求量超出当前限制。
503: 开发者API被平台暂时禁用。

仪表板 API 屏幕截图即将推出

该区域保留用于将来 API 密钥管理器和使用情况仪表板的屏幕截图。

开发者 API