swagger生成api编写指南

swagger生成api的接口文档yaml版本

#必要字段!Swagger规范版本,必须填2.0,否则该YAML将不能用于Swagger其他组件
swagger: ‘2.0’
#必要字段!描述API接口信息的元数据
info:
#接口标题
title: swagger说明文档 
#接口文档的描述
description: 学习Swagger
#版本号
version: 1.0.0
#Swagger会提供测试用例,host指定测试时的主机名,如果没有指定就是当前主机,可以指定端口.
host: 127.0.0.1
#定义的api的前缀,必须已/开头,测试用例的主机则为:host+bashPath
basePath: /api
#指定调用接口的协议,必须是:“http”, “https”, “ws”, “wss”.默认是http.-表示是个数组元素,即schemes接受一个数组参数
schemes:

  • http
  • https
    #对应与http协议头request的Accept,调用者可接受类型,默认是*/*,定义的类型必须是http协议定义的 Mime Types,RestfulAPI一般定义成application/json
    #这两个是对所有接口的全局设置,在细化的接口中是还可以对应这两个属性来覆盖全局属性
    produces:
  • application/json
    #必要字段!定义可有可操作的API
    paths:
    /users:
    #必要字段!定义HTTP操作方法,必须是http协议定义的方法
    get:
    #接口概要
    summary: 查询所有用户信息
    #接口描述
    description: 查询出所有用户的所有信息,用户名,别名
    #标签,方便快速过滤出User相关的接口
    tags:
    - User
    #返回值描述,必要自动
    responses:
    #返回的http状态码
    200:
    description: 所有用户信息或
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值