Rename 'additionalProp1' in docs to a more descriptive one

First Check

• I added a very descriptive title to this issue.
• I used the GitHub search to find a similar issue and didn’t find it.
• I searched the FastAPI documentation, with the integrated search.
• I already searched in Google “How to X in FastAPI” and didn’t find any information.
• I already read and followed all the tutorial in the docs and didn’t find an answer.
• I already checked if it is not related to FastAPI but to Pydantic.
• I already checked if it is not related to FastAPI but to Swagger UI.
• I already checked if it is not related to FastAPI but to ReDoc.

Commit to Help

• I commit to help with one of those options 👆

Example Code

from fastapi import FastAPI
from pydantic import BaseModel, Field, parse_obj_as

app = FastAPI()

City = str  # a type alias

class Misc(BaseModel):
    content: dict = Field(description="All other data here.")

class CompanyDataOut(BaseModel):
    __root__: dict[City, Misc]

@app.post("/", response_model=CompanyDataOut)
async def test():
    m = Misc(content={})
    return {"New York": m}

Description

Open the docs.

It shows response example as:

{
  "additionalProp1": {
    "content": {}
  },
  "additionalProp2": {
    "content": {}
  },
  "additionalProp3": {
    "content": {}
  }
}

Instead of ‘additionalProp1,2,3’ I would like to see ‘city1,2,3’, to let the user know that the key is a city, like below :

{
  "city1": {
    "content": {}
  },
  "city2": {
    "content": {}
  },
  "city3": {
    "content": {}
  }
}

Operating System

Windows

Operating System Details

No response

FastAPI Version

0.70.0

Python Version

3.10

Additional Context

No response

[Jedore]

You can add a custom example:

class CompanyDataOut(BaseModel):
    __root__: dict[City, Misc] = Field(example="""
{
  "city1": {
    "content": {}
  },
  "city2": {
    "content": {}
  },
  "city3": {
    "content": {}
  }
}""")

[github-actions[bot]]

Assuming the original need was handled, this will be automatically closed now. But feel free to add more comments or create new issues or PRs.