## Добавление ASGI middleware { #adding-asgi-middlewares }

Так как **FastAPI** основан на Starlette и реализует спецификацию <abbr title="Asynchronous Server Gateway Interface – Асинхронный шлюзовой интерфейс сервера">ASGI</abbr>, вы можете использовать любое ASGI middleware.

Middleware не обязательно должно быть сделано специально для FastAPI или Starlette — достаточно, чтобы оно соответствовало спецификации ASGI.

Trotzdem können Sie das in **FastAPI** tun, indem Sie eines der internen Tools von Starlette verwenden.

Die Dokumentation würde weiterhin funktionieren, allerdings wird nicht dokumentiert werden, dass der Parameter ein Pfad sein sollte.

### Pfad-Konverter { #path-convertor }

同理，你可以照常宣告其他參數，並另外同時取得 `Request`。

///

## `Request` 文件 { #request-documentation }

你可以在 [Starlette 官方文件站點中的 `Request` 物件](https://www.starlette.dev/requests/) 了解更多細節。

/// note | 技術細節

你也可以使用 `from starlette.requests import Request`。

FastAPI 之所以直接提供它，是為了讓開發者更方便；但它本身是來自 Starlette。

///

/// note | Технічні деталі

Можна також використати `from starlette.templating import Jinja2Templates`.

**FastAPI** надає той самий `starlette.templating` як `fastapi.templating` просто для зручності для вас, розробника. Але більшість доступних відповідей надходять безпосередньо зі Starlette. Так само з `Request` і `StaticFiles`.

///

## Створення шаблонів { #writing-templates }

- 匯入 `StaticFiles`。
- 在特定路徑上「掛載」一個 `StaticFiles()` 實例。

{* ../../docs_src/static_files/tutorial001_py310.py hl[2,6] *}

/// note | 技術細節

你也可以使用 `from starlette.staticfiles import StaticFiles`。

**FastAPI** 為了方便開發者，提供與 `starlette.staticfiles` 相同的介面作為 `fastapi.staticfiles`。但它其實是直接來自 Starlette。

///

### 什麼是「掛載」 { #what-is-mounting }

「掛載（mounting）」是指在特定路徑下加入一個完整且「獨立」的應用，之後所有該路徑下的子路徑都由它處理。

/// note | 技术细节

你也可以使用`from starlette.responses import Response` 或者 `from starlette.responses import JSONResponse`。

为了方便开发者，**FastAPI** 封装了相同数据类型，如`starlette.responses` 和 `fastapi.responses`。不过大部分response对象都是直接引用自Starlette。

因为`Response`对象可以非常便捷的设置headers和cookies，所以 **FastAPI** 同时也封装了`fastapi.Response`。

///

/// note

在 FastAPI 0.108.0、Starlette 0.29.0 之前，`name` 是第一個參數。

此外，在更早的版本中，`request` 物件是作為 context 的鍵值對之一傳給 Jinja2 的。

///

/// tip

透過宣告 `response_class=HTMLResponse`，文件 UI 能夠知道回應將會是 HTML。

///

/// note | 技術細節

你也可以使用 `from starlette.templating import Jinja2Templates`。

    /**
     * The result or output from the script execution.
     * This field contains any output or result data from the script.
     */
    public String scriptResult;

    /**
     * The timestamp when the job started execution.
     * This is a required field indicating when the job began.
     */
    @Required
    public String startTime;

    /**
     * The timestamp when the job completed execution.

from fastapi import FastAPI
from pydantic import BaseModel, Field
from starlette.testclient import TestClient

app = FastAPI()


class Item(BaseModel):
    name: str = Field(alias="aliased_name")
    price: float | None = None
    owner_ids: list[int] | None = None


@app.get("/items/valid", response_model=Item)
def get_valid():
    return Item(aliased_name="valid", price=1.0)


@app.get("/items/coerce", response_model=Item)

### More info { #more-info }

/// note | Technical Details

You could also use `from starlette.responses import Response` or `from starlette.responses import JSONResponse`.

**FastAPI** provides the same `starlette.responses` as `fastapi.responses` just as a convenience for you, the developer. But most of the available responses come directly from Starlette.