value: String,
    ) = commonHeader(name, value)

    /**
     * Adds a header with [name] and [value]. Prefer this method for multiply-valued
     * headers like "Cookie".
     *
     * Note that for some headers including `Content-Length` and `Content-Encoding`,
     * OkHttp may replace [value] with a header derived from the request body.
     */
    open fun addHeader(
      name: String,

pkg syscall (freebsd-arm64), const NOTE_EXIT ideal-int
pkg syscall (freebsd-arm64), const NOTE_EXTEND = 4
pkg syscall (freebsd-arm64), const NOTE_EXTEND ideal-int
pkg syscall (freebsd-arm64), const NOTE_FFAND = 1073741824
pkg syscall (freebsd-arm64), const NOTE_FFAND ideal-int
pkg syscall (freebsd-arm64), const NOTE_FFCOPY = 3221225472
pkg syscall (freebsd-arm64), const NOTE_FFCOPY ideal-int

   * }
   * ```
   *
   * The caller may read the response body with the response's [Response.body] method. To avoid
   * leaking resources callers must [close the response body][ResponseBody] or the response.
   *
   * Note that transport-layer success (receiving a HTTP response code, headers and body) does not
   * necessarily indicate application-layer success: `response` may still indicate an unhappy HTTP
   * response code like 404 or 500.
   *

```

!!! warning "注意"
    上記の例のように `Response` を明示的に返す場合、それは直接返されます。

    モデルなどはシリアライズされません。

    必要なデータが含まれていることや、値が有効なJSONであること (`JSONResponse` を使う場合) を確認してください。

!!! note "技術詳細"
    `from starlette.responses import JSONResponse` を利用することもできます。

    **FastAPI** は `fastapi.responses` と同じ `starlette.responses` を、開発者の利便性のために提供しています。しかし有効なレスポンスはほとんどStarletteから来ています。 `status` についても同じです。

### GNU/Linux and macOS

```sh
docker-compose pull
docker-compose up
```

    ```

=== "Python 3.8+ non-Annotated"

    !!! tip
        尽可能选择使用 `Annotated` 的版本。

    ```Python hl_lines="10"
    {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
    ```

!!! note
    路径参数总是必需的，因为它必须是路径的一部分。

    所以，你应该在声明时使用 `...` 将其标记为必需参数。

    然而，即使你使用 `None` 声明路径参数或设置一个其他默认值也不会有任何影响，它依然会是必需参数。

## 按需对参数排序

假设你想要声明一个必需的 `str` 类型查询参数 `q`。

For those cases, you can use the `jsonable_encoder` to convert your data before passing it to a response:

```Python hl_lines="6-7  21-22"
{!../../../docs_src/response_directly/tutorial001.py!}
```

!!! note "Technical Details"
    You could also use `from starlette.responses import JSONResponse`.

    !!! tip "Заметка"
        Рекомендуется использовать версию с `Annotated`, если это возможно.

    ```Python hl_lines="19-21"
    {!> ../../../docs_src/body_multiple_params/tutorial001.py!}
    ```

!!! note "Заметка"
    Заметьте, что в данном случае параметр `item`, который будет взят из тела запроса, необязателен. Так как было установлено значение `None` по умолчанию.

## Несколько параметров тела запроса

  - If there are any errors, read the error and fix your code.
  - IMPORTANT NOTE: if the first import fails, you have to select and apply `Synchronization disabled`, then repeat the step above.
    Otherwise, TeamCity complains "Can't find the previous revision, please commit current settings first".

Sie erhalten also einen sauberen Error mit einem Statuscode `418` und dem JSON-Inhalt:

```JSON
{"message": "Oops! yolo did something. There goes a rainbow..."}
```

!!! note "Technische Details"
    Sie können auch `from starlette.requests import Request` und `from starlette.responses import JSONResponse` verwenden.