CoderMy的博客

转载至阮一峰老师的文章，是我看到的多篇文章中最为通俗易懂的一、协议API与用户的通信协议，总是使用HTTPs协议。二、域名应该尽量将API部署在专用域名之下。https://api.example.com如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。https://example.org/api/三、版本（Versioning）应该将API的版本号放入URL。https://api.example.com/v1/另一种做法是，将版本号放在HTTP头信息

前言相信无论是前端或是后端的程序员对Swagger都不怎么陌生，没有用过应该也听说过Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。简单的配置后，就能生成一份清晰的API文档。但是不知道大家有没有发现Swagger原生的ui似乎并不支持对请求头的操作，在我之前整合JWT时遇到过这样的问题，当时的解决办法是设置全局参数。但对我来说还是花费了一些时间去学习，但是这样的方法只能适用于特定的请求头，耦合度很高，如果需要别的参数，还要再修改代码。

一、ToBeTopJavaer （16.6k Star)JAVA工程师成神之路，我直接吹爆，这是本人最喜欢的java学习类项目，内容涵盖java基础、计算机基础、设计模式、算法、JVM、SpringCloud、常用工具、源码阅读等等等等。。。只有你想不到的知识，没有它没包含的知识。github地址:https://github.com/hollischuang/toBeTopJavaergithubpage阅读地址: https://hollischuang.github.io/toBeTopJav