MailGo轻邮

一次请求，
通过 Gmail 发信。

从网站或 App 的后端调用 MailGo，已连接的 Gmail 自动作为发件人。

开始接入

连接 Gmail 后，在我的账户中复制 API Key。如果你通过邀请加入，邀请方可以在授权后帮你完成接入。 打开我的账户

发送邮件

curl https://mailgo.w1.nz/v1/send \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"to":"recipient@example.com","subject":"New enquiry","text":"A new message from your website.","replyTo":"visitor@example.com"}'
字段要求
to必填，一个收件邮箱。
subject必填，最多 200 个字符，不接受换行。
text / html至少提供一个，每个最多 50,000 字符；同时提供则生成两种格式。
replyTo选填，回复地址。

不支持自定义发件人、抄送、密送、附件或批量收件人。整个请求最多 128 KiB。

处理返回结果

{"ok":true,"status":"accepted"}

accepted 表示 Gmail 接受了请求，最终投递结果以 Gmail 为准。MailGo 不保留邮件内容、邮件 ID、发送历史或计数。

状态处理方式
400 / 413 / 415检查字段、JSON 格式和请求大小。
401 invalid_api_key检查 Key，或在账户中重新复制。
403 account_inactive在账户中恢复发信或连接 Gmail。
409 gmail_reconnect_required在账户中重新授权 Gmail，或获取新的邀请。
429 gmail_limit_reachedGmail 暂时达到限制，请稍后再试。
422 gmail_rejectedGmail 拒绝了请求，请检查收件人和账户。
502 delivery_uncertain先检查 Gmail“已发送”。请求可能已成功，直接重试可能重复发送。
503服务暂时不可用，请稍后再试。

Key 只放在后端

网页和手机 App 通过自己的后端调用 MailGo，不要将 Key 放在客户端代码中。你的产品自行处理输入校验、防机器人和重复提交。

MailGo 不排队、不自动重试，也不对请求去重。每个 Gmail 账户仍受 Google 自身发送额度限制。