```Python
from typing import Union

from fastapi import FastAPI

app = FastAPI()


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


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

<details markdown="1">

### Khởi tạo

* Tạo một tệp tin `main.py` như sau:

```Python
from typing import Union

from fastapi import FastAPI

app = FastAPI()


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


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

<details markdown="1">

* Ṣẹ̀dá fáìlì `main.py (èyí tíí ṣe, akọkọ.py)` pẹ̀lú:

```Python
from typing import Union

from fastapi import FastAPI

app = FastAPI()


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


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

<details markdown="1">

</div>

## アプリケーション例

### アプリケーションの作成

- `main.py` を作成し、以下のコードを入力します:

```Python
from fastapi import FastAPI

app = FastAPI()


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


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

<details markdown="1">

### Confira

Abra o seu navegador em <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.

Você verá essa resposta em JSON:

```JSON
{"message": "Hello World"}
```

### Documentação Interativa de APIs

Agora vá para <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.

```

해당 줄은 로컬에서 앱이 서비스되는 URL을 보여줍니다.

### 확인하기

브라우저로 <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>를 여세요.

아래와 같은 JSON 응답을 볼 수 있습니다:

```JSON
{"message": "Hello World"}
```

### 대화형 API 문서

이제 <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>로 가봅니다.

pkg syscall (darwin-arm64), const IPPROTO_GRE = 47
pkg syscall (darwin-arm64), const IPPROTO_GRE ideal-int
pkg syscall (darwin-arm64), const IPPROTO_HELLO = 63
pkg syscall (darwin-arm64), const IPPROTO_HELLO ideal-int
pkg syscall (darwin-arm64), const IPPROTO_HMP = 20
pkg syscall (darwin-arm64), const IPPROTO_HMP ideal-int
pkg syscall (darwin-arm64), const IPPROTO_HOPOPTS = 0

pkg syscall (freebsd-arm64), const IPPROTO_GRE = 47
pkg syscall (freebsd-arm64), const IPPROTO_GRE ideal-int
pkg syscall (freebsd-arm64), const IPPROTO_HELLO = 63
pkg syscall (freebsd-arm64), const IPPROTO_HELLO ideal-int
pkg syscall (freebsd-arm64), const IPPROTO_HMP = 20
pkg syscall (freebsd-arm64), const IPPROTO_HMP ideal-int
pkg syscall (freebsd-arm64), const IPPROTO_HOPOPTS = 0

pkg syscall (darwin-386), const IPPROTO_GGP ideal-int
pkg syscall (darwin-386), const IPPROTO_GMTP ideal-int
pkg syscall (darwin-386), const IPPROTO_GRE ideal-int
pkg syscall (darwin-386), const IPPROTO_HELLO ideal-int
pkg syscall (darwin-386), const IPPROTO_HMP ideal-int
pkg syscall (darwin-386), const IPPROTO_HOPOPTS ideal-int
pkg syscall (darwin-386), const IPPROTO_ICMP ideal-int

response = requests.get("http://example.com/some/url")
```

Die entsprechende *Pfadoperation* der FastAPI-API könnte wie folgt aussehen:

```Python hl_lines="1"
@app.get("/some/url")
def read_url():
    return {"message": "Hello World"}
```

Sehen Sie sich die Ähnlichkeiten in `requests.get(...)` und `@app.get(...)` an.

!!! check "Inspirierte **FastAPI**"
    * Über eine einfache und intuitive API zu verfügen.