一、OpenAPIv3

    详细的OpenAPIv3协议介绍请参考:https://swagger.io/specification/

    二、g.Meta元数据

    接口的元数据信息可以通过为输入结构体 embedded 方式嵌入 g.Meta 结构,并通过 g.Meta 的属性标签方式来实现。

    三、常用协议标签

    输入输出结构体中的属性的标签完整支持OpenAPIv3协议,因此只要增加了对应的协议标签,那么生成的OpenAPIv3接口信息中将会自动包含该属性。

    大部分的标签属性已经被Server组件自动生成,开发者需要手动设置的标签不多。常见的标签包括:

    四、扩展OpenAPIv3信息

    核心的接口信息已经自动生成,如果开发者想要更进一步完善接口信息,可以通过s.GetOpenApi()接口获取到OpenAPIv3的结构体对象,并手动填充对应的属性内容即可。我们来看一个示例,在该示例中,我们将接口中的标签进行了自定义的排序,并且增加了对每个标签的详细描述: