Auth
AM 的 Auth 端点让你无需自行管理令牌、会话或安全细节，即可构建登录、注册和密码相关流程。
这些端点运行在你的认证域名上，覆盖从注册到密码重置的完整认证生命周期。
概览
端点
| Endpoint | 用途 |
|---|---|
POST /auth/sign-up |
使用邮箱/密码注册新用户 |
POST /auth/sign-in |
使用凭据认证 |
POST /auth/sign-in-with-token |
无密码令牌登录 |
GET /auth/me |
获取当前用户资料 |
POST /auth/refresh |
刷新访问令牌 |
GET /auth/csrf-session |
初始化 CSRF 会话 Cookie |
GET /auth/csrf-token |
生成 CSRF 令牌 |
POST /auth/check-email |
检查邮箱及可用登录方式 |
POST /auth/verify |
验证邮箱地址 |
POST /auth/send-magic-link |
发送无密码登录链接 |
POST /auth/send-password-reset |
发送密码重置邮件 |
POST /auth/reset-password |
使用重置令牌设置新密码 |
POST /auth/accept-invite |
接受账户邀请 |
认证流程
返回内容
认证成功后会返回：
- Access Token：短期 JWT（默认 1 小时），用于 API 请求
- Refresh Token：长期令牌（默认 14 天），用于换取新的访问令牌
- User Profile：邮箱、成员关系、身份信息
CSRF 防护
会修改状态的请求必须携带 CSRF 令牌：
- 初始化会话：
GET /auth/csrf-session（设置 HttpOnly Cookie） - 获取令牌：
GET /auth/csrf-token（在X-CSRF-TokenHeader 返回令牌） - 在请求中通过
X-CSRF-TokenHeader 或csrf_tokenBody 字段传递令牌