from fastapi import FastAPI, Request

app = FastAPI()


@app.get("/items/{item_id}")
def read_root(item_id: str, request: Request):
    client_host = request.client.host

        // Test parsing field with list
        String xml = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" + "<doc>\n" + "  <field name=\"tags\">\n" + "    <list>\n"
                + "      <item>tag1</item>\n" + "      <item>tag2</item>\n" + "      <item>tag3</item>\n" + "    </list>\n" + "  </field>\n"
                + "</doc>";

        AccessResultDataImpl<?> accessResultData = new AccessResultDataImpl<>();

from typing import Annotated

from fastapi import FastAPI, Query

app = FastAPI()


@app.get("/items/")
async def read_items(q: Annotated[list[str] | None, Query()] = None):
    query_items = {"q": q}

                .orElse(OptionalEntity.empty());
    }

    /**
     * Retrieves a specific stopword item by its ID.
     *
     * @param dictId The ID of the dictionary.
     * @param id     The ID of the stopword item.
     * @return An optional entity containing the stopword item, or empty if not found.
     */
    public OptionalEntity<StopwordsItem> getStopwordsItem(final String dictId, final long id) {

                .orElse(OptionalEntity.empty());
    }

    /**
     * Retrieves a specific synonym item by its ID.
     *
     * @param dictId The ID of the dictionary.
     * @param id     The ID of the synonym item.
     * @return An optional entity containing the synonym item, or empty if not found.
     */
    public OptionalEntity<SynonymItem> getSynonymItem(final String dictId, final long id) {

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

from typing import Annotated

from fastapi import Depends, FastAPI
from fastapi.security import OAuth2PasswordBearer

app = FastAPI()

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")


@app.get("/items/")
async def read_items(token: Annotated[str, Depends(oauth2_scheme)]):

Wenn der Client beispielsweise versucht, einen `tool` Query-Parameter mit dem Wert `plumbus` zu senden, wie:

```http
https://example.com/items/?limit=10&tool=plumbus
```

erhält er eine **Error-Response**, die ihm mitteilt, dass der Query-Parameter `tool` nicht erlaubt ist:

```json
{
    "detail": [
        {
            "type": "extra_forbidden",

For example, if the client tries to send a `tool` query parameter with a value of `plumbus`, like:

```http
https://example.com/items/?limit=10&tool=plumbus
```

They will receive an **error** response telling them that the query parameter `tool` is not allowed:

```json
{
    "detail": [
        {
            "type": "extra_forbidden",

from typing import Union

from fastapi import FastAPI, Query

app = FastAPI()


@app.get("/items/")
async def read_items(
    hidden_query: Union[str, None] = Query(default=None, include_in_schema=False),
):
    if hidden_query:
        return {"hidden_query": hidden_query}
    else: