From 8ebe0055871cdb635de5ba435daef37f53a2270d Mon Sep 17 00:00:00 2001 From: Anya299 Date: Fri, 9 Jan 2026 07:24:52 +0530 Subject: [PATCH] Clarify "Required, can be None" section in query params docs Added explanation on handling required query parameters that can accept None in FastAPI. --- .../tutorial/query-params-str-validations.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/de/docs/tutorial/query-params-str-validations.md b/docs/de/docs/tutorial/query-params-str-validations.md index 8977dbcd5..5d57b3316 100644 --- a/docs/de/docs/tutorial/query-params-str-validations.md +++ b/docs/de/docs/tutorial/query-params-str-validations.md @@ -244,6 +244,24 @@ Wenn Sie einen Wert als erforderlich deklarieren müssen, während Sie `Query` v {* ../../docs_src/query_params_str_validations/tutorial006_an_py39.py hl[9] *} ### Erforderlich, kann `None` sein { #required-can-be-none } +Even though a query parameter is required, it can still accept `None` if handled correctly in the code. +For example: + +```python +from typing import Annotated +from fastapi import FastAPI, Query + +app = FastAPI() + +@app.get("/items/") +async def read_items(q: Annotated[str | None, Query()]): # required + if q == "null": + q = None + + results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]} + if q is not None: + results.update({"q": q}) + return results Sie können deklarieren, dass ein Parameter `None` akzeptieren kann, aber trotzdem erforderlich ist. Dadurch müssten Clients den Wert senden, selbst wenn der Wert `None` ist.