註冊與登入 API - BearLab AI

這些介面用於主控臺帳號驗證。第三方登入方式只有在 BearLab 頁面顯示並啟用時才可用。

帳號密碼

方法	路徑	用途
`GET`	`/api/verification`	傳送郵箱驗證碼
`POST`	`/api/user/register`	註冊帳號
`POST`	`/api/user/login`	使用者登入
`GET`	`/api/user/logout`	退出目前登入
`GET`	`/api/reset_password`	傳送密碼重設郵件
`POST`	`/api/user/reset`	使用驗證碼重設密碼
`POST`	`/api/user/login/2fa`	完成兩步驗證登入
`GET`	`/api/user/groups`	取得註冊或登入頁面可選的使用者分組

Passkey 登入

方法	路徑	用途
`POST`	`/api/user/passkey/login/begin`	取得 Passkey 登入挑戰
`POST`	`/api/user/passkey/login/finish`	提交瀏覽器回傳的驗證結果

Passkey 的 begin 和 finish 必須在同一次瀏覽器驗證流程中配對呼叫，不要手工構造驗證器回傳值。

OAuth 登入

方法	路徑	用途
`GET`	`/api/oauth/state`	產生 OAuth State
`GET`	`/api/oauth/github`	GitHub 登入
`GET`	`/api/oauth/discord`	Discord 登入
`GET`	`/api/oauth/oidc`	OIDC 登入
`GET`	`/api/oauth/linuxdo`	LinuxDO 登入
`GET`	`/api/oauth/telegram/login`	Telegram 登入
`GET`	`/api/oauth/telegram/bind`	綁定 Telegram
`GET`	`/api/oauth/wechat`	微信登入
`GET`	`/api/oauth/wechat/bind`	綁定微信
`GET`	`/api/oauth/email/bind`	綁定郵箱

BearLab 只開放主控臺目前顯示的提供商。使用者端應先讀取頁面狀態，不要寫死某個平臺一定可用。

瀏覽器登入優先使用主控臺頁面。只有在開發自有前端時才需要直接呼叫這些驗證介面。