Browse Source

docs api说明

jay 2 years ago
parent
commit
c872547596

+ 10 - 0
iot-starter/src/main/java/cc/iotkit/web/controller/AuthController.java

@@ -21,6 +21,8 @@ import cc.iotkit.web.service.SysRegisterService;
 import cn.dev33.satoken.annotation.SaIgnore;
 import cn.dev33.satoken.annotation.SaIgnore;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.collection.CollUtil;
 
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotBlank;
 import lombok.RequiredArgsConstructor;
 import lombok.RequiredArgsConstructor;
 
 
@@ -36,6 +38,7 @@ import java.util.List;
  *
  *
  * @author Lion Li
  * @author Lion Li
  */
  */
+@Api(tags = "认证")
 @SaIgnore
 @SaIgnore
 @Validated
 @Validated
 @RequiredArgsConstructor
 @RequiredArgsConstructor
@@ -54,6 +57,7 @@ public class AuthController {
      * @param body 登录信息
      * @param body 登录信息
      * @return 结果
      * @return 结果
      */
      */
+    @ApiOperation("登录")
     @PostMapping("/login")
     @PostMapping("/login")
     public LoginVo login(@Validated @RequestBody LoginBody body) {
     public LoginVo login(@Validated @RequestBody LoginBody body) {
         LoginVo loginVo = new LoginVo();
         LoginVo loginVo = new LoginVo();
@@ -72,6 +76,7 @@ public class AuthController {
      * @param body 登录信息
      * @param body 登录信息
      * @return 结果
      * @return 结果
      */
      */
+    @ApiOperation("短信登录")
     @PostMapping("/smsLogin")
     @PostMapping("/smsLogin")
     public LoginVo smsLogin(@Validated @RequestBody SmsLoginBody body) {
     public LoginVo smsLogin(@Validated @RequestBody SmsLoginBody body) {
         LoginVo loginVo = new LoginVo();
         LoginVo loginVo = new LoginVo();
@@ -87,6 +92,7 @@ public class AuthController {
      * @param body 登录信息
      * @param body 登录信息
      * @return 结果
      * @return 结果
      */
      */
+    @ApiOperation("邮件登录")
     @PostMapping("/emailLogin")
     @PostMapping("/emailLogin")
     public LoginVo emailLogin(@Validated @RequestBody EmailLoginBody body) {
     public LoginVo emailLogin(@Validated @RequestBody EmailLoginBody body) {
         LoginVo loginVo = new LoginVo();
         LoginVo loginVo = new LoginVo();
@@ -102,6 +108,7 @@ public class AuthController {
      * @param xcxCode 小程序code
      * @param xcxCode 小程序code
      * @return 结果
      * @return 结果
      */
      */
+    @ApiOperation("小程序登录")
     @PostMapping("/xcxLogin")
     @PostMapping("/xcxLogin")
     public LoginVo xcxLogin(@NotBlank(message = "{xcx.code.not.blank}") String xcxCode) {
     public LoginVo xcxLogin(@NotBlank(message = "{xcx.code.not.blank}") String xcxCode) {
         LoginVo loginVo = new LoginVo();
         LoginVo loginVo = new LoginVo();
@@ -114,6 +121,7 @@ public class AuthController {
     /**
     /**
      * 退出登录
      * 退出登录
      */
      */
+    @ApiOperation("退出登录")
     @PostMapping("/logout")
     @PostMapping("/logout")
     public void logout() {
     public void logout() {
         loginService.logout();
         loginService.logout();
@@ -123,6 +131,7 @@ public class AuthController {
     /**
     /**
      * 用户注册
      * 用户注册
      */
      */
+    @ApiOperation("用户注册")
     @PostMapping("/register")
     @PostMapping("/register")
     public void register(@Validated @RequestBody RegisterBody user) {
     public void register(@Validated @RequestBody RegisterBody user) {
         if (!configService.selectRegisterEnabled(user.getTenantId())) {
         if (!configService.selectRegisterEnabled(user.getTenantId())) {
@@ -137,6 +146,7 @@ public class AuthController {
      *
      *
      * @return 租户列表
      * @return 租户列表
      */
      */
+    @ApiOperation("登录页面租户下拉框")
     @GetMapping("/tenant/list")
     @GetMapping("/tenant/list")
     public LoginTenantVo tenantList(HttpServletRequest request) throws Exception {
     public LoginTenantVo tenantList(HttpServletRequest request) throws Exception {
         List<SysTenantVo> tenantList = tenantService.queryList(new SysTenantBo());
         List<SysTenantVo> tenantList = tenantService.queryList(new SysTenantBo());

+ 4 - 0
iot-starter/src/main/java/cc/iotkit/web/controller/CaptchaController.java

@@ -15,6 +15,8 @@ import cn.hutool.captcha.AbstractCaptcha;
 import cn.hutool.captcha.generator.CodeGenerator;
 import cn.hutool.captcha.generator.CodeGenerator;
 import cn.hutool.core.util.IdUtil;
 import cn.hutool.core.util.IdUtil;
 import cn.hutool.core.util.RandomUtil;
 import cn.hutool.core.util.RandomUtil;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotBlank;
 import lombok.RequiredArgsConstructor;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import lombok.extern.slf4j.Slf4j;
@@ -40,6 +42,7 @@ import java.util.Map;
 @Validated
 @Validated
 @RequiredArgsConstructor
 @RequiredArgsConstructor
 @RestController
 @RestController
+@Api(tags = "验证码")
 public class CaptchaController {
 public class CaptchaController {
 
 
     private final CaptchaProperties captchaProperties;
     private final CaptchaProperties captchaProperties;
@@ -97,6 +100,7 @@ public class CaptchaController {
     /**
     /**
      * 生成验证码
      * 生成验证码
      */
      */
+    @ApiOperation(value = "生成验证码")
     @GetMapping("/code")
     @GetMapping("/code")
     public CaptchaVo getCode() {
     public CaptchaVo getCode() {
         CaptchaVo captchaVo = new CaptchaVo();
         CaptchaVo captchaVo = new CaptchaVo();