dev-only 邮件 outbox

GET /api/v1/dev/outbox · getDevOutbox

仅在 GAMEFLOW_DEV=1 启用。返回内存 outbox 中的邮件（含验证/重置/邀请链接），供 E2E 取链接。生产禁用。

公开端点，无需鉴权。

响应字段 · 200

items（必填）: OutboxMessage[]
items[].to（必填）: string
items[].subject（必填）: string
items[].kind（必填）: enum；取值：verification / verification_code / password_reset / invitation
items[].link（必填）: string
items[].code: string —— 验证码明文，仅 verification_code 类邮件非空（dev outbox 本地取码用）
items[].sentAt（必填）: string

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/dev/outbox"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "to": "示例文本",
      "subject": "示例文本",
      "kind": "verification",
      "link": "https://example.com",
      "sentAt": "示例文本"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引