Как настроить ответные сообщения для документации ReDoc OpenAPI в FastAPI?

Прямо из документации:

Вы можете захотеть иметь некоторые предопределенные ответы, которые применимы ко многим операции пути, но вы хотите объединить их с пользовательскими ответами, необходимыми для каждой операции пути.

В этих случаях вы можете использовать технику Python для «распаковки» dict с **dict_to_unpack:

json old_dict = {
    "old key": "old value",
    "second old key": "second old value", 
} 
new_dict = {**old_dict, "new key": "new value"} 

Здесь new_dict будет содержать все пары ключ-значение из old_dict плюс новая пара ключ-значение:

json {
    "old key": "old value",
    "second old key": "second old value",
    "new key": "new value", 
} 

Вы можете использовать эту технику для повторного использования некоторых предопределенных ответов в вашем операции пути и комбинировать их с дополнительными пользовательскими.

Рабочий пример

from typing import Union

from fastapi import FastAPI
from fastapi.responses import FileResponse
from pydantic import BaseModel


class Item(BaseModel):
    id: str
    value: str


responses = {
    404: {"description": "Item not found"},
    302: {"description": "The item was moved"},
    403: {"description": "Not enough privileges"},
}


app = FastAPI()


@app.get(
    "/items/{item_id}",
    response_model=Item,
    responses = {**responses, 200: {"content": {"image/png": {}}}},
)
async def read_item(item_id: str, img: Union[bool, None] = None):
    if img:
        return FileResponse("image.png", media_type = "image/png")
    else:
        return {"id": "foo", "value": "there goes my hero"}