首页 > 其他分享 >fastapi手动添加swagger文档描述

fastapi手动添加swagger文档描述

时间:2023-10-11 23:58:18浏览次数:52  
标签:__ name fastapi 添加 文档 swagger responses

fastapi手动添加swagger文档描述

"""
在正常开发过程中,fastapi会自动地将正确响应(status=200)和输入校验失败响应(status=422)添加到文档中.
当有自定义的响应描述添加到文档中时,就需要我们手动添加到路径函数的:responses参数中.
用户可以按照openapi的语法,将响应的描述信息添加到这个参数中,fastapi会正确地将他们渲染出来.
"""

# 示例:

# 假设我们需要添加描述:当响应状态码为200时,响应头会包含"X-Token"这个参数

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class UserOut(BaseModel):
   name: str


@app.get('/user', response_model=UserOut,
        responses={
            200: {'headers':
                      {"X-token": {"type": "string", "description": "用户token"}}
                  }
        })
async def test(user_name: str):
   msg = {'name': user_name}
   return msg


if __name__ == '__main__':
   import uvicorn

   uvicorn.run(app='test:app', workers=1)

# 文档展示

 

"""
可以看到,文档中即包含了fastapi自动生成的内容,也包含了我们手动添加的内容,所以我们不需要完全重新编排内容给responses参数.
综上,基于openapi语法,我们可以很方便地添加自定义文章内容到fastapi文档中.
"""

参考连接:
   https://fastapi.tiangolo.com/zh/advanced/additional-responses/?h=responses
 
 
 

标签:__,name,fastapi,添加,文档,swagger,responses
From: https://www.cnblogs.com/CJTARRR/p/17758516.html

相关文章

  • 操作索引库-创建索引库(索引库相当于数据库,文档相当于数据库中的表,一种即具有相同数据
    创建索引库时可先定义映射,类似数据库中的约束 {"mappings":{"properties":{"title":{"type":"text"},"name":{"type":"text"},"created_at......
  • pageoffice多用户同时在线编辑word文档
    转载:多用户同时编辑多用户同时编辑注意本文中展示的代码均为关键代码,复制粘贴到您的项目中,按照实际的情况,例如文档路径,用户名等做适当修改即可使用。总体来说,各种Web系统中的Word文档在线处理大体可以分为以下四种流转处理方式:A用户编辑完,流转给B用户修改,再流转给C用户修改,直......
  • 什么是词频-逆文档频率(TF-IDF)?
    我们玩AI会听说一个词叫做向量化,那么什么是向量化呢?文本向量化:将文本信息表示成能够表达文本语义的向量,是用数值向量来表示文本的语义。词嵌入(WordEmbedding):一种将文本中的词转换成数字向量的方法,属于文本向量化处理的范畴。常见的文本向量和词嵌入方法包括独热模型(OneHot......
  • fastapi swagger文档无法渲染问题
    由于fastapi默认使用国外的cdn获得支持swagger文档的js和css文件,所以在国内,/docs接口渲染不出来.解决方法1#在app生效之前,将生成swagger文档的方法替换掉.(在fastapi为:fastapi.openapi.docs.get_swagger_ui_html)​fromfastapiimportFastAPI,applicationsfromfa......
  • SpringBoot 2.7.x 整合 swagger2 冲突问题
    问题描述SpringBoot2.7.x版本在整合swagger2时抛出异常如下:复制代码org.springframework.context.ApplicationContextException:Failedtostartbean'documentationPluginsBootstrapper';nestedexceptionisjava.lang.NullPointerException atorg.springframework......
  • 运算符-包机制-javaDoc生成文档
    publicclassDemo12{publicstaticvoidmain(String[]args){//与(and)或(or)非(取反)booleana=true;booleanb=false;System.out.println("a&&b:"+(b&&a));//逻辑与运算:两个变量都为真,结果才为trueSystem.......
  • 软件开发项目管理体系,支撑体系,测试体系文档大全
    在软件开发过程中,文档起着至关重要的作用。它不仅记录了项目或产品的基本信息,而且还是团队成员之间沟通的重要媒介。本文将详细介绍软件开发文档的作用、结构、撰写方法以及审校步骤,以帮助读者更好地理解和应用文档在软件开发中的价值。一、认识文档文档是软件开发过程中的产物......
  • 应用系统的相关运维有关的文档 包含哪些分类
    应用系统的相关运维文档通常包括多个分类,以便组织、管理和维护系统的运维信息。以下是常见的应用系统运维文档分类:系统架构和设计文档:系统架构图:系统的结构、组件和关系的图示。系统设计文档:系统的设计原则、流程、数据模型等详细描述。安装与部署文档:安装指南:系统的......
  • “云听”小程序的设计与实现-计算机毕业设计源码+LW文档
    摘 要随着时代的发展我国的移动互联网也逐渐的完善,很是时候人们希望通过移动设备听歌和听一些小说文学作品等内容,但是一些市面上的相关软件要么是收费的,要么是有大量的广告,为了让大家有一个干净的听读环境,我们通过微信小程序开发了本次的”云听”小程序。本基于微信小程序的”......
  • 文档图片的切边与扭曲矫正
     ......