@app.get("/path_example/{item_id}")
        def path_example(
            item_id: str = Path(
                example="item_1",
            ),
        ):
            return item_id

    @app.get("/path_examples/{item_id}")
    def path_examples(
        item_id: str = Path(
            examples=["item_1", "item_2"],
        ),
    ):
        return item_id

                "description": "Path One Description",
                "value": "item_1",
            },
            "Path Two": {
                "value": "item_2",
            },
        },
    ),
):
    return item_id


@app.get("/query_examples/")
def query_examples(
    data: str | None = Query(
        default=None,
        examples=[
            "json_schema_query1",

        List<String> initialList = new ArrayList<>();
        initialList.add("item1");
        initialList.add("item2");
        dataMap.put("items", initialList);

        // Add a new value
        transformer.putResultDataBody(dataMap, "items", "item3");

        Object result = dataMap.get("items");
        assertTrue(result instanceof Object[]);
        Object[] resultArray = (Object[]) result;

        StopwordsItem item3 = new StopwordsItem(1, "word");

        // Two items with null input should be equal
        assertTrue(item1.equals(item2));

        // Item with null input should not equal item with non-null input
        assertFalse(item3.equals(item1));
        assertFalse(item1.equals(item3));

        // Symmetry
        assertTrue(item1.equals(item2));

    if user_id is None:
        return [{"item_id": "i1", "user_id": "u1"}, {"item_id": "i2", "user_id": "u2"}]
    else:
        return [{"item_id": "i2", "user_id": user_id}]


@item_router.get("/{item_id}")
def get_item(item_id: str, user_id: str | None = None):
    if user_id is None:
        return {"item_id": item_id}
    else:
        return {"item_id": item_id, "user_id": user_id}

        // Test getting non-existing item
        OptionalEntity<ProtwordsItem> item = protwordsFile.get(999);
        assertFalse(item.isPresent());
    }

    @Test
    public void test_get_withUnloadedData() {
        // Test getting item when data is not loaded yet
        OptionalEntity<ProtwordsItem> item = protwordsFile.get(1);
        assertTrue(item.isPresent());
        assertEquals("test1", item.get().getInput());
    }

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    is_offer: bool | None = None


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}


@app.put("/items/{item_id}")
def update_item(item_id: int, item: Item):

用浏览器打开 [http://127.0.0.1:8000/items/5?q=somequery](http://127.0.0.1:8000/items/5?q=somequery)。

你会看到如下 JSON 响应：

```JSON
{"item_id": 5, "q": "somequery"}
```

你已经创建了一个 API，它可以：

* 在路径 `/` 和 `/items/{item_id}` 接收 HTTP 请求。
* 以上两个路径都接受 `GET` 操作（也称为 HTTP 方法）。
* 路径 `/items/{item_id}` 有一个应为 `int` 的路径参数 `item_id`。
* 路径 `/items/{item_id}` 有一个可选的 `str` 类型查询参数 `q`。

Der Wert des Pfad-Parameters `item_id` wird Ihrer Funktion als das Argument `item_id` übergeben.

Wenn Sie dieses Beispiel ausführen und auf [http://127.0.0.1:8000/items/foo](http://127.0.0.1:8000/items/foo) gehen, sehen Sie als <abbr title="Response – Antwort: Daten, die der Server zum anfragenden Client zurücksendet">Response</abbr>:

```JSON
{"item_id":"foo"}
```

파이썬의 포맷 문자열 리터럴에서 사용되는 문법을 이용하여 경로 "매개변수" 또는 "변수"를 선언할 수 있습니다:

{* ../../docs_src/path_params/tutorial001_py310.py hl[6:7] *}

경로 매개변수 `item_id`의 값은 함수의 `item_id` 인자로 전달됩니다.

그래서 이 예제를 실행하고 [http://127.0.0.1:8000/items/foo](http://127.0.0.1:8000/items/foo)로 이동하면, 다음 응답을 볼 수 있습니다:

```JSON
{"item_id":"foo"}
```

## 타입이 있는 경로 매개변수 { #path-parameters-with-types }

파이썬 표준 타입 어노테이션을 사용하여 함수에 있는 경로 매개변수의 타입을 선언할 수 있습니다: