auth
身份驗證
託管登入頁與 REST／SDK 註冊登入、OAuth 授權碼 + PKCE、JWT 存取權杖。
OpenAPI 路徑
共 40 個操作（method + path + summary）
| Method | Path | Summary |
|---|---|---|
| GET | /oauth/authorize | 授權端點 |
| GET | /oauth/google/callback | Google OAuth 回調（平台統一） |
| POST | /oauth/google/exchange | 原生 SDK：以 id_token 或 google_code 換 session／OAuth code |
| POST | /oauth/google/resume | 原生：WebView 完成 consent／補資料後續跑 authorize |
| GET | /oauth/google/start | 啟動 Google OAuth（平台統一） |
| POST | /oauth/token | 用授權碼或 refresh_token 換發 access token |
| POST | /v1/auth/accept-terms | 半登錄同意條款並重跑 gate |
| GET | /v1/auth/account | App 帳號中心快照（full session） |
| PATCH | /v1/auth/account/profile | 更新顯示名稱／頭像 URL／簡介／地址 |
| POST | /v1/auth/consent | 半登錄資料權限同意並重跑 gate |
| GET | /v1/auth/consent/requirements | 查詢 App 資料權限欄位（必填／選填／關閉） |
| POST | /v1/auth/login | 終端用戶登入 |
| POST | /v1/auth/logout | 撤銷 refresh token |
| POST | /v1/auth/magic-link/request | 請求 Magic Link 登入信 |
| POST | /v1/auth/magic-link/verify | 驗證 Magic Link 並登入 |
| POST | /v1/auth/mfa/recovery/regenerate | 重產復原碼 |
| POST | /v1/auth/mfa/recovery/verify | 使用復原碼完成 MFA |
| POST | /v1/auth/mfa/skip | 略過建議開啟的 MFA 並重跑 gate |
| GET | /v1/auth/mfa/status | MFA 綁定狀態與可用方法 |
| DELETE | /v1/auth/mfa/totp | 解除 TOTP 綁定 |
| POST | /v1/auth/mfa/totp/begin | 開始 TOTP 綁定 |
| POST | /v1/auth/mfa/totp/confirm | 確認 TOTP 綁定 |
| POST | /v1/auth/mfa/totp/verify | 登入／半登錄 TOTP 驗證 |
| POST | /v1/auth/mfa/webauthn/auth/options | Passkey 登入 options |
| POST | /v1/auth/mfa/webauthn/auth/verify | Passkey 登入 verify |
| POST | /v1/auth/mfa/webauthn/register/options | Passkey 註冊 options |
| POST | /v1/auth/mfa/webauthn/register/verify | Passkey 註冊 verify |
| DELETE | /v1/auth/mfa/webauthn/{credentialId} | 移除 Passkey |
| POST | /v1/auth/password/recovery/confirm | 忘記密碼：核對驗證碼並取得 reset_token |
| POST | /v1/auth/password/recovery/lookup | 忘記密碼：依帳號回傳部分聯絡方式 |
| POST | /v1/auth/password/recovery/send | 忘記密碼：核對完整聯絡方式後寄出驗證碼或連結 |
| POST | /v1/auth/password/reset | 以 reset_token 重設密碼 |
| POST | /v1/auth/profile/complete | 補齊必填個資（complete-profile） |
| POST | /v1/auth/refresh | 刷新 access token |
| POST | /v1/auth/register | 終端用戶註冊 |
| DELETE | /v1/auth/users/{userId} | 解除用戶綁定（可能刪除全球帳號） |
| GET | /v1/dev/apps/{id}/audit-events | 開發者操作審計列表（合規） |
| GET | /v1/dev/apps/{id}/codes/stats | 碼用量統計（開發者控制台；平台權限） |
| GET | /v1/dev/apps/{id}/users | 列出 App 用戶（開發者） |
| DELETE | /v1/dev/apps/{id}/users/{userId} | 解除 App 用戶綁定（開發者） |