说明

本文档主要介绍与用户登录相关的客户端获取 Token 接口，及一些特殊说明，登录授权介绍请参考 OAuth授权介绍

OAuth 密码模式

• API：POST /oauth/oauth/token
• 场景：需要用户登录，通过 用户名+密码 获取 Token

OAuth 客户端模式

• API：POST /oauth/oauth/token
• 场景：无需用户登录，只获取 Token，一般用于外部系统接口调用

标准登录接口

登录接口

• API：POST /oauth/oauth/token
• 场景：仿Web端登录，需要用户登录，且需要用户输入验证码

• 请求参数

获取初始化参数

• API：GET /oauth/login/init-params?channel={channel}&client_id={clientId}
• 场景：进入登录页面时，调用该接口获取一些初始化信息

• 请求参数

• 响应参数

生成验证码

• API：GET /oauth/public/captcha-code
• 场景：如果 isNeedCaptcha = true，首先调用该接口获取验证码的 Key

获取图形验证码

• API：GET /oauth/public/captcha/{captchaKey}
• 场景：通过上一步得到 captchaKey 后，再调用该接口获取验证码图片

手机短信登录

登录接口

• API：POST /oauth/token/mobile
• 场景：通过 手机+短信验证码 登录，需要用户输入手机验证码

• 请求参数

获取手机验证码

• API：/oauth/public/send-phone-captcha

接口返回说明

请求失败

可通过 success=false 判断接口是否调用失败，如果调用失败，返回失败编码 code 及消息 message。

请求成功

请求成功则返回 access_token

接口返回码