item01 - Code Search

docs/zh/docs/advanced/behind-a-proxy.md

</div>

### 使用 HTTPS 的重定向 { #redirects-with-https }

例如，假设你定义了一个*路径操作* `/items/`：

{* ../../docs_src/behind_a_proxy/tutorial001_01_py310.py hl[6] *}

如果客户端尝试访问 `/items`，默认会被重定向到 `/items/`。

但在设置 *CLI 选项* `--forwarded-allow-ips` 之前，它可能会重定向到 `http://localhost:8000/items/`。

而你的应用可能托管在 `https://mysuperapp.com`，重定向应当是 `https://mysuperapp.com/items/`。

通过设置 `--proxy-headers`，FastAPI 现在就可以重定向到正确的位置。😎

```

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Fri Mar 20 17:06:37 GMT 2026

- 15.1K bytes

- Click Count (0)

github.com/apache/maven

compat/maven-embedder/src/site/site.xml

  <edit>${project.scm.url}</edit>

  <body>
    <menu name="Overview">
      <item name="Introduction" href="index.html"/>
      <item name="Javadocs" href="apidocs/index.html"/>
      <item name="Source Xref" href="xref/index.html"/>
      <!--item name="FAQ" href="faq.html"/-->
    </menu>
  </body>

Created: Sun Apr 05 03:35:12 GMT 2026

- Last Modified: Fri Mar 21 04:56:21 GMT 2025

- 1.3K bytes

- Click Count (0)

github.com/tiangolo/fastapi

docs_src/header_param_models/tutorial001_an_py310.py

app = FastAPI()


class CommonHeaders(BaseModel):
    host: str
    save_data: bool
    if_modified_since: str | None = None
    traceparent: str | None = None
    x_tag: list[str] = []


@app.get("/items/")
async def read_items(headers: Annotated[CommonHeaders, Header()]):

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Tue Sep 17 18:54:10 GMT 2024

- 392 bytes

- Click Count (0)

github.com/apache/maven

api/maven-api-di/src/site/site.xml

  <edit>${project.scm.url}</edit>

  <body>
    <menu name="Overview">
      <item name="Introduction" href="index.html"/>
      <item name="Javadocs" href="apidocs/index.html"/>
      <item name="Source Xref" href="xref/index.html"/>
      <!--item name="FAQ" href="faq.html"/-->
    </menu>

    <menu ref="parent"/>
    <menu ref="reports"/>
  </body>

Created: Sun Apr 05 03:35:12 GMT 2026

- Last Modified: Fri Mar 21 04:56:21 GMT 2025

- 1.3K bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_param_include_in_schema.py

                        "properties": {
                            "detail": {
                                "title": "Detail",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/ValidationError"
                                },
                            }
                        },
                    },

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Tue Feb 17 09:59:14 GMT 2026

- 8.6K bytes

- Click Count (0)

github.com/elastic/elasticsearch

.ci/os.ps1

$ErrorActionPreference="Stop"
$gradleInit = "C:\Users\$env:username\.gradle\init.d\"
echo "Remove $gradleInit"
Remove-Item -Recurse -Force $gradleInit -ErrorAction Ignore
New-Item -ItemType directory -Path $gradleInit
echo "Copy .ci/init.gradle to $gradleInit"
Copy-Item .ci/init.gradle -Destination $gradleInit

[Environment]::SetEnvironmentVariable("JAVA_HOME", $null, "Machine")

Created: Wed Apr 08 16:19:15 GMT 2026

- Last Modified: Wed Jul 08 20:49:46 GMT 2020

- 1.3K bytes

- Click Count (0)

github.com/tiangolo/fastapi

docs/ja/docs/tutorial/stream-json-lines.md

sequenceDiagram
    participant App
    participant Client

    App->>App: Produce Item 1
    App->>Client: Send Item 1
    App->>App: Produce Item 2
    Client->>Client: Process Item 1
    App->>Client: Send Item 2
    App->>App: Produce Item 3
    Client->>Client: Process Item 2
    App->>Client: Send Item 3
    Client->>Client: Process Item 3
    Note over App: Keeps producing...
    Note over Client: Keeps consuming...
```

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Thu Mar 19 18:55:22 GMT 2026

- 5.1K bytes

- Click Count (0)

github.com/tiangolo/fastapi

docs_src/cookie_params/tutorial001_py310.py

from fastapi import Cookie, FastAPI

app = FastAPI()


@app.get("/items/")
async def read_items(ads_id: str | None = Cookie(default=None)):

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Fri May 13 23:38:22 GMT 2022

- 170 bytes

- Click Count (0)

github.com/tiangolo/fastapi

docs/ru/docs/tutorial/metadata.md

    * `url` (**обязательно**): `str`-значение с URL-адресом для внешней документации.

### Создание метаданных для тегов { #create-metadata-for-tags }

Давайте попробуем сделать это на примере с тегами для `users` и `items`.

Создайте метаданные для ваших тегов и передайте их в параметре `openapi_tags`:

{* ../../docs_src/metadata/tutorial004_py310.py hl[3:16,18] *}

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Thu Mar 19 17:56:20 GMT 2026

- 9.2K bytes

- Click Count (0)

github.com/tiangolo/fastapi

tests/test_pydanticv2_dataclasses_uuid_stringified_annotations.py

from fastapi.testclient import TestClient
from inline_snapshot import snapshot


@dataclass
class Item:
    id: uuid.UUID
    name: str
    price: float
    tags: list[str] = field(default_factory=list)
    description: str | None = None
    tax: float | None = None


app = FastAPI()


@app.get("/item", response_model=Item)
async def read_item():
    return {
        "id": uuid.uuid4(),

Created: Sun Apr 05 07:19:11 GMT 2026

- Last Modified: Mon Mar 16 10:16:48 GMT 2026

- 1.1K bytes

- Click Count (0)

Search Options