今天被前端训了一顿,慌得一逼,说你们写的接口,返回值写的是什么东西,只有公共的三个字段......

十多年的兰坪网站建设经验，针对设计、前端、开发、售后、文案、推广等六对一服务，响应快，48小时及时工作处理。营销型网站建设的优势是能够根据用户设备显示端的尺寸不同，自动调整兰坪建站的显示方式，使网站能够适用不同显示终端，在浏览器中调整网站的宽度，无论在任何一种浏览器上浏览网站，都能展现优雅布局与设计，从而大程度地提升浏览体验。成都创新互联公司从事“兰坪网站设计”,“兰坪网站推广”以来，每个客户项目都认真落实执行。

我们的API文档是基于 swagger 组件写的.如是有了下面的东东

示例:

1.1.          返回字段

1.1.1. 返回字段(对象)

1.    将现有接口 @ApiOperation 注解,response字段去掉.

该字段作用:声明指定返回值对象

修改后:

2.    将返回对象进行泛型声明

声明后swagger(丝袜哥) 会反射生成对象字段描述

 

3.    使用 @ApiModelPropety 注解写明字段含义

@ApiModelProperty("XXX")

示例:

 

1.1.2. 返回字段(单字段)

对于单字段及5个字段以内,可以用此方式说明返回值

1.2.     请求字段

1.2.1. 请求字段(对象)

接口入参声明为对象接收

 

对象字段用 @ApiParam 注解进行标注

 

1.2.2. 请求字段(单字段或多字段)

单字段或多字段用 @ApiImplicitParams @ApiImplicitParam 进行标注

另外有需要云服务器可以了解下创新互联scvps.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。

分享名称：swagger返回值描述-创新互联
网址分享：http://cdweb.net/article/dsgdss.html