--- /dev/null
+# νμ μμ©νλ‘κ·Έλ¨ - λ§μ΄νΈ
+
+λ§μ½ κ°κ°μ λ
립μ μΈ OpenAPIμ λ¬Έμ UIλ₯Ό κ°λ λ κ°μ λ
립μ μΈ FastAPI μμ©νλ‘κ·Έλ¨μ΄ νμνλ€λ©΄, λ©μΈ μ΄ν리μΌμ΄μ
μ νλ (λλ κ·Έ μ΄μμ) νμ-μμ©νλ‘κ·Έλ¨(λ€)μ βλ§μ΄νΈ"ν΄μ μ¬μ©ν μ μμ΅λλ€.
+
+## **FastAPI** μμ©νλ‘κ·Έλ¨ λ§μ΄νΈ
+
+βλ§μ΄νΈ"μ΄λ μμ ν βλ
립μ μΈ" μμ©νλ‘κ·Έλ¨μ νΉμ κ²½λ‘μ μΆκ°νμ¬ ν΄λΉ νμ μμ©νλ‘κ·Έλ¨μμ μ μΈλ *κ²½λ‘ λμ*μ ν΅ν΄ ν΄λΉ κ²½λ‘ μλμ μλ λͺ¨λ μμ
λ€μ μ²λ¦¬ν μ μλλ‘ νλ κ²μ μλ―Έν©λλ€.
+
+### μ΅μλ¨ μμ©νλ‘κ·Έλ¨
+
+λ¨Όμ , λ©μΈ, μ΅μλ¨μ **FastAPI** μμ©νλ‘κ·Έλ¨κ³Ό μ΄κ²μ *κ²½λ‘ λμ*μ μμ±ν©λλ€:
+
+{* ../../docs_src/sub_applications/tutorial001.py hl[3, 6:8] *}
+
+### νμ μμ©νλ‘κ·Έλ¨
+
+λ€μμΌλ‘, νμ μμ©νλ‘κ·Έλ¨κ³Ό μ΄κ²μ *κ²½λ‘ λμ*μ μμ±ν©λλ€:
+
+μ΄ νμ μμ©νλ‘κ·Έλ¨μ λ λ€λ₯Έ νμ€ FastAPI μμ©νλ‘κ·Έλ¨μ
λλ€. λ€λ§ μ΄κ²μ βλ§μ΄νΈβλ κ²μ
λλ€:
+
+{* ../../docs_src/sub_applications/tutorial001.py hl[11, 14:16] *}
+
+### νμ μμ©νλ‘κ·Έλ¨ λ§μ΄νΈ
+
+μ΅μλ¨ μμ©νλ‘κ·Έλ¨, `app`μ νμ μμ©νλ‘κ·Έλ¨, `subapi`λ₯Ό λ§μ΄νΈν©λλ€.
+
+μ΄ μμμμ, νμ μμ©νλ‘κ·Έλ¨μ
μ `/subapi` κ²½λ‘μ λ§μ΄νΈ λ κ²μ
λλ€:
+
+{* ../../docs_src/sub_applications/tutorial001.py hl[11, 19] *}
+
+### μλμΌλ‘ μμ±λ API λ¬Έμ νμΈ
+
+μ΄μ , `uvicorn`μΌλ‘ λ©μΈ μμ©νλ‘κ·Έλ¨μ μ€ννμμμ€. λΉμ μ νμΌμ΄ `main.py`λΌλ©΄, μ΄λ κ² μ€νν©λλ€:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+κ·Έλ¦¬κ³ <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>μμ λ¬Έμλ₯Ό μ¬μμμ€.
+
+λ©μΈ μμ©νλ‘κ·Έλ¨μ *κ²½λ‘ λμ*λ§μ ν¬ν¨νλ, λ©μΈ μμ©νλ‘κ·Έλ¨μ λν μλ API λ¬Έμλ₯Ό νμΈν μ μμ΅λλ€:
+
+<img src="https://fastapi.tiangolo.com//img/tutorial/sub-applications/image01.png">
+
+λ€μμΌλ‘, <a href="http://127.0.0.1:8000/subapi/docs" class="external-link" target="_blank">http://127.0.0.1:8000/subapi/docs</a>μμ νμ μμ©νλ‘κ·Έλ¨μ λ¬Έμλ₯Ό μ¬μμμ€.
+
+νμ κ²½λ‘ μ λμ¬ `/subapi` μλμ μ μΈλ *κ²½λ‘ λμ* μ ν¬ν¨νλ, νμ μμ©νλ‘κ·Έλ¨μ λν μλ API λ¬Έμλ₯Ό νμΈν μ μμ΅λλ€:
+
+<img src="https://fastapi.tiangolo.com//img/tutorial/sub-applications/image02.png">
+
+λ μ¬μ©μ μΈν°νμ΄μ€ μ€ μ΄λ νλλ₯Ό μ¬μ©ν΄μΌνλ κ²½μ°, λΈλΌμ°μ λ νΉμ μμ©νλ‘κ·Έλ¨ λλ νμ μμ©νλ‘κ·Έλ¨κ³Ό κ°κ° ν΅μ ν μ μκΈ° λλ¬Έμ μ¬λ°λ₯΄κ² λμν κ²μ
λλ€.
+
+### κΈ°μ μ μΈλΆμ¬ν: `root_path`
+
+μμ μ€λͺ
λ κ²κ³Ό κ°μ΄ νμ μμ©νλ‘κ·Έλ¨μ λ§μ΄νΈνλ κ²½μ°, FastAPIλ `root_path`λΌκ³ νλ ASGI λͺ
μΈμ 맀컀λμ¦μ μ¬μ©νμ¬ νμ μμ©νλ‘κ·Έλ¨μ λν λ§μ΄νΈ κ²½λ‘ ν΅μ μ μ²λ¦¬ν©λλ€.
+
+μ΄λ₯Ό ν΅ν΄, νμ μμ©νλ‘κ·Έλ¨μ λ¬Έμ UIλ₯Ό μν΄ κ²½λ‘ μ λμ¬λ₯Ό μ¬μ©ν΄μΌ νλ€λ μ¬μ€μ μΈμ§ν©λλ€.
+
+νμ μμ©νλ‘κ·Έλ¨μλ μμ λ€λ₯Έ νμ μμ©νλ‘κ·Έλ¨μ λ§μ΄νΈνλ κ²μ΄ κ°λ₯νλ©° FastAPIκ° λͺ¨λ `root_path` λ€μ μλμ μΌλ‘ μ²λ¦¬νκΈ° λλ¬Έμ λͺ¨λ κ²μ μ¬λ°λ₯΄κ² λμν κ²μ
λλ€.
+
+`root_path`μ μ΄κ²μ μ¬μ©νλ λ°©λ²μ λν΄μλ [νλ‘μμ λ·λ¨](./behind-a-proxy.md){.internal-link target=_blank} μΉμ
μμ λ°°μΈ μ μμ΅λλ€.