mirror of
https://github.com/fastapi/fastapi.git
synced 2025-12-30 09:39:20 -05:00
9262fa8362
* ✨ Do not require default value in Query(), Path(), Header(), etc * 📝 Update source examples for docs with default and required values * ✅ Update tests with new default values and not required Ellipsis * 📝 Update docs for Query params and update info about default value, required, Ellipsis
50 lines
1.3 KiB
Python
50 lines
1.3 KiB
Python
from fastapi import Body, FastAPI
|
|
from pydantic import BaseModel
|
|
|
|
app = FastAPI()
|
|
|
|
|
|
class Item(BaseModel):
|
|
name: str
|
|
description: str | None = None
|
|
price: float
|
|
tax: float | None = None
|
|
|
|
|
|
@app.put("/items/{item_id}")
|
|
async def update_item(
|
|
*,
|
|
item_id: int,
|
|
item: Item = Body(
|
|
examples={
|
|
"normal": {
|
|
"summary": "A normal example",
|
|
"description": "A **normal** item works correctly.",
|
|
"value": {
|
|
"name": "Foo",
|
|
"description": "A very nice Item",
|
|
"price": 35.4,
|
|
"tax": 3.2,
|
|
},
|
|
},
|
|
"converted": {
|
|
"summary": "An example with converted data",
|
|
"description": "FastAPI can convert price `strings` to actual `numbers` automatically",
|
|
"value": {
|
|
"name": "Bar",
|
|
"price": "35.4",
|
|
},
|
|
},
|
|
"invalid": {
|
|
"summary": "Invalid data is rejected with an error",
|
|
"value": {
|
|
"name": "Baz",
|
|
"price": "thirty five point four",
|
|
},
|
|
},
|
|
},
|
|
),
|
|
):
|
|
results = {"item_id": item_id, "item": item}
|
|
return results
|