JavaScript SDK

此时rootauth对象的使用方式更简洁

const rootauth = useRootAuth()
rootauth?.xxx()

6.3 API 方法说明

登录、注册、发送验证码和重置密码均返回 Promise，第二个参数可传入自定义回调（onSuccess/onFailure）来覆盖 SDK 默认行为。

若只需补充额外逻辑（如关闭 loading），请直接使用 Promise（.then().catch()），不要传入第二个参数，SDK 会保留默认行为。

6.3.1 登录

const rootauth = useRootAuth()

interface LoginParams {
  type: string // 必填项，登陆方式：EMAIL_PASS|EMAIL_CODE，现在支持账号密码登陆EMAIL_PASS和邮箱验证码登陆EMAIL_CODE
  email: string // 必填项，用户邮箱
  password?: string // 当type为EMAIL_PASS必填，注意：仅需要传入明文密码，RootAuth进行加密处理
  code?: string // 当type为EMAIL_CODE必填
}
interface RootAuthFlowCallbacks<T = unknown> {
  onSuccess?: (data: T) => void
  onFailure?: (error: unknown) => void
}

//可使用的类型
rootauth?.login(
  params: LoginParams,
  callbacks?: RootAuthFlowCallbacks<
    AxiosResponse<ApiResponse<{ redirect_url: string }>>
  >,
)
.then((res) => {
  // 基于当前的RootAuth逻辑，补充自有逻辑
})
.catch((err) => {
  console.log('err', err)
})
.finally(() => {
  // 关闭loading等
})

带自定义回调示例：

const handleSubmit=()=>{
  // 用户自行处理前置校验
  loading.value = true
  rootauth?.login({
    type:'EMAIL_PASS',
    email:'123456@qq.com',
    password:'123456'
  },
  {
    onSuccess:()=>{
      // 用户自己的登录成功回调，包括提示等
    },
    onFailure:()=>{
      // 用户自己的登录失败回调，包括提示等
    }
  })
  .finally(() => {
    loading.value = false
  })
}

6.3.2 注册

interface RegisterParams {
  type?: string // 用户注册类型：EMAIL_CODE，默认为邮箱验证码注册EMAIL_CODE
  email: string // 必填项，用户邮箱
  code: string // 必填项，邮箱激活码
  password: string // 必填项，密码，注意：仅需要传入明文密码，RootAuth进行加密处理
}

const params: RegisterParams = {
  email: '123456@qq.com',
  password: '123456',
  code: '123456',
}
  
rootauth?.register(params)
.then((res) => {
  // 基于当前的RootAuth逻辑，补充自有逻辑
})
.catch((err) => {
  console.error(err)
})
.finally(() => {
})

6.3.3 发送验证码

interface SendCodeParams {
  type?: string // 发送验证码类型：EMAIL，默认为邮箱验证码EMAIL
  email: string // 必填项，用户邮箱
  email_template_type: string // 必填项，选择的模板类型：register_code|login_code|reset_pass_code，register_code：注册验证码，login_code：登录验证码，reset_pass_code：重置验证码
}

const params: SendCodeParams = {
  email: '123456@qq.com',
  email_template_type: 'register_code'
}
  
rootauth?.sendCode(params)
.then((res) => {
  // 基于当前的RootAuth逻辑，补充自有逻辑
})
.catch((err) => {
  console.error(err)
})
.finally(() => {
})

6.3.4 重置密码

interface ResetPasswordUParams {
  type?: string // 发验证码类型：EMAIL_CODE，默认为邮箱验证码EMAIL_CODE
  email: string
  password: string // 新密码，注意：仅需要传入明文密码，RootAuth进行加密处理
  password_confirmation: string // 确认密码，注意：仅需要传入明文密码，RootAuth进行加密处理
  code: string
}

const params: ResetPasswordUParams = {
  email: '123456@qq.com',
  password: '123456',
  password_confirmation: '123456',
  code: '111111'
}
  
rootauth?.resetPassword(params)
.then((res) => {
  // 基于当前的RootAuth逻辑，补充自有逻辑
})
.catch((err) => {
  console.error(err)
})
.finally(() => {
})

6.3.5 第三方登录（Google OAuth）

interface ThirdPartyLoginParams {
  auth_by: string // 第三方类型：google_oauth，google_oauth：谷歌登陆
}

const params: ThirdPartyLoginParams = {
  auth_by: 'google_oauth'
}
  
rootauth?.thirdPartyLogin(params)
.then((res) => {
  // 基于当前的RootAuth逻辑，补充自有逻辑
})
.catch((err) => {
  console.error(err)
})
.finally(() => {
})

6.3.6 Google One Tap 登录

需先在配置中开启 enable_google_one_tap: true

rootauth?.googleOneTapLogin()