在真实的开发中,会有手机接口有n多个版本的接口,在管理上非常的混乱,调用方在这种情况下,根本不知道我需要调用的是哪个版本的接口,时间一长,开发这个接口的人他们也不知道了,这样的开发环境,在我们周边其实是非常常见的,下面是我用swagger 来解决的方案。
从上图可以看到这里访问的url是相同的,但是headers 里的参数 apiVersion 的值不同,1.0和1.1 ,这里通过配置 apiImpliciParam 的 allowableValues 的值就可在配置中设置了。
下面是最后展示的图:
这里的这个配置还可以支持,像type 这类定义好了的字段,这样可以避免前端的乱输入情况,例如:
最后:希望大家能利用swagger 解决身边坑爹的需求,谢谢大家的支持!