# cloud-api-doc-demo

**Repository Path**: kblang/cloud-api-doc-demo

## Basic Information

- **Project Name**: cloud-api-doc-demo
- **Description**: eureka + zuul + swagger2 3.0版本
网关集成了各个服务Api，即可用一个端口访问多个服务
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-27
- **Last Updated**: 2022-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## eureka + zuul 整合 swagger2 3.0

### 简述
使用zuul 作为springcloud 网关，并引入swagger2作为Api 在线文档

### 步骤
* 创建eureka注册中心
* 创建user-api 和 eureka-client 应用，并引入了swagger2,；注册到eureka
* 创建swagger2应用，引入zuul、swagger2，注册到eureka；配置路由，路由到user-api和eureka-client
* 启动eureka-server --> user-api、eureka-client --> swagger2
* 打开地址: http://localhost:8080/swagger-ui/index.html 即可查询到不同服务Api 文档
注: 各个Api 应用本身的端口也可以看自己的文档，网关只是集成而已

版本二:
* 在各个 service 中使用了 context-path, 需要在 zuul中添加 filter, 使网关添加的前缀不会生效

如访问出现: /user-api/user-api/info


### 参考链接
[[简书] Swagger2 Zuul 整合](https://www.jianshu.com/p/af4ff19afa04)