FastAPI 允許你為參數宣告額外的資訊與驗證。

以下面這個應用為例：

{* ../../docs_src/query_params_str_validations/tutorial001_py310.py hl[7] *}

查詢參數 `q` 的型別是 `str | None`，表示它是 `str` 但也可以是 `None`，而且預設值就是 `None`，因此 FastAPI 會知道它不是必填。

/// note | 注意

FastAPI 會因為預設值是 `= None` 而知道 `q` 不是必填。

使用 `str | None` 也能讓你的編輯器提供更好的支援並偵測錯誤。

///

## 額外驗證 { #additional-validation }

我們要強制：即使 `q` 是可選，只要提供了，長度就不能超過 50 個字元。

Query параметр `q` має тип `str | None`, що означає, що він має тип `str`, але також може бути `None`, і справді, значення за замовчуванням — `None`, тож FastAPI знатиме, що він не є обов'язковим.

/// note | Примітка

FastAPI знатиме, що значення `q` не є обов’язковим, завдяки значенню за замовчуванням `= None`.

Ian Lance Taylor <******@****.***> 1765577893 -0800

Joe Tsai <******@****.***> 1472512232 -0700

Joe Tsai <******@****.***> 1503105518 -0700

The query parameter `q` is of type `str | None`, that means that it's of type `str` but could also be `None`, and indeed, the default value is `None`, so FastAPI will know it's not required.

/// note

FastAPI will know that the value of `q` is not required because of the default value `= None`.

Having `str | None` will allow your editor to give you better support and detect errors.

///

Joe Tsai <******@****.***> 1503528984 -0700

Ian Lance Taylor <******@****.***> 1765577893 -0800

El parámetro de query `q` es de tipo `str | None`, lo que significa que es de tipo `str` pero también podría ser `None`, y de hecho, el valor por defecto es `None`, así que FastAPI sabrá que no es requerido.

/// note | Nota

FastAPI sabrá que el valor de `q` no es requerido por el valor por defecto `= None`.

Tener `str | None` permitirá que tu editor te dé un mejor soporte y detecte errores.

///

**FastAPI** 允许你为参数声明额外的信息和校验。

让我们以下面的应用为例：

{* ../../docs_src/query_params_str_validations/tutorial001_py310.py hl[7] *}

查询参数 `q` 的类型为 `str | None`，这意味着它是 `str` 类型，但也可以是 `None`。其默认值确实为 `None`，所以 FastAPI 会知道它不是必填的。

/// note | 注意

FastAPI 会因为默认值 `= None` 而知道 `q` 的值不是必填的。

将类型标注为 `str | None` 能让你的编辑器提供更好的辅助和错误检测。

///

## 额外校验 { #additional-validation }

我们打算添加约束：即使 `q` 是可选的，但只要提供了该参数，**其长度不能超过 50 个字符**。