用户认证接口完整测试页面

接口文档概览

基础认证接口

POST /api/mobile/sendSmsCode - 发送短信验证码
POST /api/mobile/unifiedLogin - 统一登录

Token管理接口

POST /api/mobile/refreshToken - 刷新Token
POST /api/mobile/logout - 登出
POST /api/mobile/validateToken - 验证Token
GET /api/mobile/userInfo - 获取用户信息

发送短信验证码接口测试

接口说明

功能：发送短信验证码到指定手机号

请求地址：POST /api/mobile/sendSmsCode

说明：统一发送验证码接口（不区分注册和登录）

请求参数 (CaptchaRequest extends BaseRequest)

该类继承自 BaseRequest，包含设备相关信息

参数名	类型	必需	说明
phoneNum	String	是	手机号码，例如：13800138000
phoneInternationalCode	String	是	国际区号，默认为"86"
osVersion	String	是	操作系统版本
appVersion	String	是	应用程序版本
deviceType	String	是	设备类型，例如：iOS/Android/Web
deviceId	String	是	设备ID，设备唯一标识
deviceName	String	是	设备名称
deviceModel	String	是	设备型号

响应结果

成功：返回成功状态

失败：返回错误信息

响应码说明

响应码	含义	说明
200	成功	操作成功执行
500	系统错误	服务器内部错误
501	参数错误	请求参数不合法
502	短信发送频率过高	短信发送频率过高，请稍后再试
506	短信发送失败	短信发送失败
508	手机号码格式错误	手机号码格式不正确

国际区号

手机号码

操作系统版本

应用程序版本

设备类型

设备ID

设备名称

设备型号

统一登录接口测试

接口说明

功能：统一登录接口（自动注册+登录）

请求地址：POST /api/mobile/unifiedLogin

说明：返回TokenPair（AccessToken + RefreshToken）

请求参数 (UserLoginRequest extends BaseRequest)

该类继承自 BaseRequest，包含设备相关信息

参数名	类型	必需	说明
phone	String	是	手机号码，例如：13800138000
phoneInternationalCode	String	是	国际区号，默认为"86"
verificationCode	String	是	验证码，例如：123456
osVersion	String	是	操作系统版本
appVersion	String	是	应用程序版本
deviceType	String	是	设备类型，例如：iOS/Android/Web
deviceId	String	是	设备ID，设备唯一标识
deviceName	String	是	设备名称
deviceModel	String	是	设备型号

响应结果

成功：返回TokenPair对象（包含accessToken和refreshToken）

失败：返回错误信息

响应码说明

响应码	含义	说明
200	成功	操作成功执行
500	系统错误	服务器内部错误
501	参数错误	请求参数不合法
503	验证码错误	手机验证码校验失败
505	令牌校验失败	令牌校验失败
507	系统错误	系统错误，请稍后再试
508	手机号码格式错误	手机号码格式不正确

国际区号

手机号码

验证码

设备ID

设备类型

设备名称

设备型号

操作系统版本

应用程序版本

刷新Token接口测试

接口说明

功能：刷新Token接口

请求地址：POST /api/mobile/refreshToken

说明：使用RefreshToken获取新的AccessToken和RefreshToken

请求参数 (RefreshTokenRequest extends BaseRequest)

该类继承自 BaseRequest，包含设备相关信息

参数名	类型	必需	说明
refreshToken	String	是	刷新令牌
osVersion	String	是	操作系统版本
appVersion	String	是	应用程序版本
deviceType	String	是	设备类型，例如：iOS/Android/Web
deviceId	String	是	设备ID，设备唯一标识
deviceName	String	是	设备名称
deviceModel	String	是	设备型号

响应结果

成功：返回成功状态

失败：返回错误信息

响应码说明

响应码	含义	说明
200	成功	操作成功执行
500	必选参数不能为空	必选参数不能为空
501	参数错误	请求参数不合法
504	刷新令牌失败	刷新令牌失败

Refresh Token

登录成功后会自动填充

设备ID

操作系统版本

应用程序版本

设备类型

设备名称

设备型号

登出接口测试

接口说明

功能：登出接口

请求地址：POST /api/mobile/logout

说明：撤销指定设备的所有Token

请求参数 (RefreshTokenRequest extends BaseRequest)

该类继承自 BaseRequest，包含其所有字段

参数名	类型	必需	说明
refreshToken	String	是	刷新令牌
deviceId	String	是	设备ID，设备唯一标识
osVersion	String	是	操作系统版本
appVersion	String	是	应用程序版本
deviceType	String	是	设备类型，例如：iOS/Android/Web
deviceName	String	是	设备名称
deviceModel	String	是	设备型号

响应结果

成功：返回成功状态

失败：返回错误信息

响应码说明

响应码	含义	说明
200	成功	操作成功执行
500	必选参数不能为空	必选参数不能为空
501	参数错误	请求参数不合法
504	刷新令牌失败	刷新令牌失败
507	系统错误	系统错误

Refresh Token

登录成功后会自动填充

设备ID

操作系统版本

应用程序版本

设备类型

设备名称

设备型号

验证Token接口测试

接口说明

功能：验证Token有效性接口

请求地址：POST /api/mobile/validateToken

说明：验证AccessToken的有效性

请求参数 (ValidateTokenRequest extends BaseRequest)

该类继承自 BaseRequest，包含设备相关信息

参数名	类型	必需	说明
accessToken	String	是	访问令牌
osVersion	String	是	操作系统版本
appVersion	String	是	应用程序版本
deviceType	String	是	设备类型，例如：iOS/Android/Web
deviceId	String	是	设备ID，设备唯一标识
deviceName	String	是	设备名称
deviceModel	String	是	设备型号

响应结果

成功：返回TokenValidationResult对象（包含验证结果和用户信息）

失败：返回错误信息

获取用户信息接口测试

接口说明

功能：获取用户信息接口

请求地址：GET /api/mobile/userInfo

说明：获取当前认证用户的信息

请求参数

参数名	类型	必需	说明
Authorization	Header	是	Bearer访问令牌，格式为: Bearer {accessToken}

响应结果

成功：返回TokenValidationResult.UserInfo对象（包含用户ID、虚拟用户ID、设备ID和设备类型）

失败：返回401未授权错误

响应码说明

响应码	含义	说明
200	成功	操作成功执行
401	未授权	访问令牌无效或已过期
500	系统错误	服务器内部错误

测试说明与使用流程

发送短信验证码：首先测试发送短信验证码功能，确保手机号正确
统一登录：使用默认验证码123456进行登录，成功后会自动填充Token到其他表单
刷新Token：使用登录获得的RefreshToken测试刷新功能
验证Token：使用登录获得的AccessToken测试验证功能
获取用户信息：使用登录获得的AccessToken测试获取用户信息功能
登出：最后测试登出功能，使用登录获得的RefreshToken

注意：在非生产环境中，验证码默认为 123456