如何解决在 swagger openapi 文件中,我可以在单独的文件中有“描述”吗?
我正在为 API 编写 swagger 文档,“描述”字段变得很长,而且难以编辑。
{
"openapi": "3.0.0","info": {
"version": "2.0.0","title": "My API","description": "<h2>A very very long description</h2><p>which includes html tags</p>",...
},"paths": {
"/somepath": {
"get": {
"description": "<h3>Another</h3><p>extremely long description... </p><p>that wraps over 50 lines</p>",...
}
},
这些描述很重要,因为当用户查看 swagger 页面时,第一个显示在顶部;和其他说明出现在每个路径的开头。
是否可以在单独的文件中包含描述,然后导入/包含它?
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。