diff --git a/docs/ko/docs/index.md b/docs/ko/docs/index.md
index 8f5ff6687..099fe1eae 100644
--- a/docs/ko/docs/index.md
+++ b/docs/ko/docs/index.md
@@ -1,12 +1,8 @@
-
-{!../../../docs/missing-translation.md!}
-
-
- FastAPI framework, high performance, easy to learn, fast to code, ready for production
+ FastAPI 프레임워크, 고성능, 간편한 학습, 빠른 코드 작성, 준비된 프로덕션
@@ -22,29 +18,29 @@
---
-**Documentation**: https://fastapi.tiangolo.com
+**문서**: https://fastapi.tiangolo.com
-**Source Code**: https://github.com/tiangolo/fastapi
+**소스 코드**: https://github.com/tiangolo/fastapi
---
-FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints.
+FastAPI는 현대적이고, 빠르며(고성능), 파이썬 표준 타입 힌트에 기초한 Python3.6+의 API를 빌드하기 위한 웹 프레임워크입니다.
-The key features are:
+주요 특징으로:
-* **Fast**: Very high performance, on par with **NodeJS** and **Go** (thanks to Starlette and Pydantic). [One of the fastest Python frameworks available](#performance).
+* **빠름**: (Starlette과 Pydantic 덕분에) **NodeJS** 및 **Go**와 대등할 정도로 매우 높은 성능. [사용 가능한 가장 빠른 파이썬 프레임워크 중 하나](#performance).
-* **Fast to code**: Increase the speed to develop features by about 200% to 300%. *
-* **Fewer bugs**: Reduce about 40% of human (developer) induced errors. *
-* **Intuitive**: Great editor support. Completion everywhere. Less time debugging.
-* **Easy**: Designed to be easy to use and learn. Less time reading docs.
-* **Short**: Minimize code duplication. Multiple features from each parameter declaration. Fewer bugs.
-* **Robust**: Get production-ready code. With automatic interactive documentation.
-* **Standards-based**: Based on (and fully compatible with) the open standards for APIs: OpenAPI (previously known as Swagger) and JSON Schema.
+* **빠른 코드 작성**: 약 200%에서 300%까지 기능 개발 속도 증가. *
+* **적은 버그**: 사람(개발자)에 의한 에러 약 40% 감소. *
+* **직관적**: 훌륭한 편집기 지원. 모든 곳에서 자동완성. 적은 디버깅 시간.
+* **쉬움**: 쉽게 사용하고 배우도록 설계. 적은 문서 읽기 시간.
+* **짧음**: 코드 중복 최소화. 각 매개변수 선언의 여러 기능. 적은 버그.
+* **견고함**: 준비된 프로덕션 용 코드를 얻으세요. 자동 대화형 문서와 함께.
+* **표준 기반**: API에 대한 (완전히 호환되는) 개방형 표준 기반: OpenAPI (이전에 Swagger로 알려졌던) 및 JSON 스키마.
-* estimation based on tests on an internal development team, building production applications.
+* 내부 개발팀의 프로덕션 애플리케이션을 빌드한 테스트에 근거한 측정
-## Gold Sponsors
+## 골드 스폰서
@@ -56,66 +52,66 @@ The key features are:
-Other sponsors
+다른 스폰서
-## Opinions
+## 의견들
-"_[...] I'm using **FastAPI** a ton these days. [...] I'm actually planning to use it for all of my team's **ML services at Microsoft**. Some of them are getting integrated into the core **Windows** product and some **Office** products._"
+"_[...] 저는 요즘 **FastAPI**를 많이 사용하고 있습니다. [...] 사실 우리 팀의 **마이크로소프트 ML 서비스** 전부를 바꿀 계획입니다. 그중 일부는 핵심 **Windows**와 몇몇의 **Office** 제품들이 통합되고 있습니다._"
-
Kabir Khan -
Microsoft (ref)Kabir Khan -
마이크로소프트 (ref)Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala -
Uber (ref)Piero Molino, Yaroslav Dudin 그리고 Sai Sumanth Miryala -
우버 (ref)Kevin Glisson, Marc Vilanova, Forest Monsen -
Netflix (ref)Kevin Glisson, Marc Vilanova, Forest Monsen -
넷플릭스 (ref)
-If you are building a CLI app to be used in the terminal instead of a web API, check out **Typer**.
+웹 API 대신 터미널에서 사용할 CLI 앱을 만들고 있다면, **Typer**를 확인해 보세요.
-**Typer** is FastAPI's little sibling. And it's intended to be the **FastAPI of CLIs**. ⌨️ 🚀
+**Typer**는 FastAPI의 동생입니다. 그리고 **FastAPI의 CLI**가 되기 위해 생겼습니다. ⌨️ 🚀
-## Requirements
+## 요구사항
Python 3.6+
-FastAPI stands on the shoulders of giants:
+FastAPI는 거인들의 어깨 위에 서 있습니다:
-* Starlette for the web parts.
-* Pydantic for the data parts.
+* 웹 부분을 위한 Starlette.
+* 데이터 부분을 위한 Pydantic.
-## Installation
+## 설치
@@ -127,7 +123,7 @@ $ pip install fastapi
-You will also need an ASGI server, for production such as Uvicorn or Hypercorn.
+프로덕션을 위해 Uvicorn 또는 Hypercorn과 같은 ASGI 서버도 필요할 겁니다.
@@ -139,11 +135,11 @@ $ pip install uvicorn
-## Example
+## 예제
-### Create it
+### 만들기
-* Create a file `main.py` with:
+* `main.py` 파일을 만드세요:
```Python
from typing import Optional
@@ -164,9 +160,9 @@ def read_item(item_id: int, q: Optional[str] = None):
```
-Or use async def...
+또는 async def 사용하기...
-If your code uses `async` / `await`, use `async def`:
+여러분의 코드가 `async` / `await`을 사용한다면, `async def`를 사용하세요:
```Python hl_lines="9 14"
from typing import Optional
@@ -188,13 +184,13 @@ async def read_item(item_id: int, q: Optional[str] = None):
**Note**:
-If you don't know, check the _"In a hurry?"_ section about `async` and `await` in the docs.
+잘 모르겠다면, 문서에서 `async`와 `await`에 관한 _"급하세요?"_ 섹션을 확인해 보세요.
-### Run it
+### 실행하기
-Run the server with:
+서버를 실행하세요:
@@ -211,54 +207,54 @@ INFO: Application startup complete.
-About the command uvicorn main:app --reload...
+uvicorn main:app --reload 명령에 관하여...
-The command `uvicorn main:app` refers to:
+명령 `uvicorn main:app`은 다음을 나타냅니다:
-* `main`: the file `main.py` (the Python "module").
+* `main`: `main.py` 파일 (파이썬 "모듈").
* `app`: the object created inside of `main.py` with the line `app = FastAPI()`.
-* `--reload`: make the server restart after code changes. Only do this for development.
+* `--reload`: 코드가 변경된 후 서버 재시작하기. 개발환경에서만 사용하세요.
-### Check it
+### 확인하기
-Open your browser at http://127.0.0.1:8000/items/5?q=somequery.
+브라우저로 http://127.0.0.1:8000/items/5?q=somequery를 열어보세요.
-You will see the JSON response as:
+아래의 JSON 응답을 볼 수 있습니다:
```JSON
{"item_id": 5, "q": "somequery"}
```
-You already created an API that:
+여러분은 벌써 API를 만들었습니다:
-* Receives HTTP requests in the _paths_ `/` and `/items/{item_id}`.
-* Both _paths_ take `GET` operations (also known as HTTP _methods_).
-* The _path_ `/items/{item_id}` has a _path parameter_ `item_id` that should be an `int`.
-* The _path_ `/items/{item_id}` has an optional `str` _query parameter_ `q`.
+* _경로_ `/` 및 `/items/{item_id}`에서 HTTP 요청 받기.
+* 두 _경로_ 모두 `GET` 연산(HTTP _메소드_ 로 알려진)을 받습니다.
+* _경로_ `/items/{item_id}`는 _경로 매개변수_ `int`형 이어야 하는 `item_id`를 가지고 있습니다.
+* _경로_ `/items/{item_id}`는 선택적인 `str`형 이어야 하는 _경로 매개변수_ `q`를 가지고 있습니다.
-### Interactive API docs
+### 대화형 API 문서
-Now go to http://127.0.0.1:8000/docs.
+이제 http://127.0.0.1:8000/docs로 가보세요.
-You will see the automatic interactive API documentation (provided by Swagger UI):
+자동 대화형 API 문서를 볼 수 있습니다 (Swagger UI 제공):
-### Alternative API docs
+### 대안 API 문서
-And now, go to http://127.0.0.1:8000/redoc.
+그리고 이제 http://127.0.0.1:8000/redoc로 가보세요.
-You will see the alternative automatic documentation (provided by ReDoc):
+다른 자동 문서를 볼 수 있습니다(ReDoc 제공):
-## Example upgrade
+## 예제 개선
-Now modify the file `main.py` to receive a body from a `PUT` request.
+이제 `PUT` 요청에 있는 본문(Body)을 받기 위해 `main.py`를 수정해봅시다.
-Declare the body using standard Python types, thanks to Pydantic.
+Pydantic을 이용해 파이썬 표준 타입으로 본문을 선언합니다.
```Python hl_lines="4 9 10 11 12 25 26 27"
from typing import Optional
@@ -290,175 +286,175 @@ def update_item(item_id: int, item: Item):
return {"item_name": item.name, "item_id": item_id}
```
-The server should reload automatically (because you added `--reload` to the `uvicorn` command above).
+서버가 자동으로 리로딩 할 수 있어야 합니다 (위에서 `uvicorn` 명령에 `--reload`을 추가 했기 때문입니다).
-### Interactive API docs upgrade
+### 대화형 API 문서 업그레이드
-Now go to http://127.0.0.1:8000/docs.
+이제 http://127.0.0.1:8000/docs로 이동합니다.
-* The interactive API documentation will be automatically updated, including the new body:
+* 대화형 API 문서가 새 본문과 함께 자동으로 업데이트 합니다:
-* Click on the button "Try it out", it allows you to fill the parameters and directly interact with the API:
+* "Try it out" 버튼을 클릭하면, 매개변수를 채울 수 있게 해주고 직접 API와 상호작용 할 수 있습니다:
-* Then click on the "Execute" button, the user interface will communicate with your API, send the parameters, get the results and show them on the screen:
+* 그러고 나서 "Execute" 버튼을 누르면, 사용자 인터페이스는 API와 통신하고 매개변수를 전송하며 그 결과를 가져와서 화면에 표시합니다:
-### Alternative API docs upgrade
+### 대안 API 문서 업그레이드
-And now, go to http://127.0.0.1:8000/redoc.
+그리고 이제, http://127.0.0.1:8000/redoc로 이동합니다.
-* The alternative documentation will also reflect the new query parameter and body:
+* 대안 문서 역시 새 쿼리 매개변수와 본문을 반영합니다:
-### Recap
+### 요약
-In summary, you declare **once** the types of parameters, body, etc. as function parameters.
+요약하면, 여러분은 매개변수의 타입, 본문 등을 함수 매개변수로써 **한번에** 선언했습니다.
-You do that with standard modern Python types.
+여러분은 현대 표준 파이썬 타입으로 이를 행했습니다.
-You don't have to learn a new syntax, the methods or classes of a specific library, etc.
+새로운 문법, 특정 라이브러리의 메소드나 클래스 등을 배울 필요가 없습니다.
-Just standard **Python 3.6+**.
+그저 표준 **Python 3.6+**입니다.
-For example, for an `int`:
+예를 들어, `int`에 대해선:
```Python
item_id: int
```
-or for a more complex `Item` model:
+또는 좀 더 복잡한 `Item` 모델에 대해선:
```Python
item: Item
```
-...and with that single declaration you get:
+...그리고 단 하나의 선언으로 여러분이 얻는 것은:
-* Editor support, including:
- * Completion.
- * Type checks.
-* Validation of data:
- * Automatic and clear errors when the data is invalid.
- * Validation even for deeply nested JSON objects.
-* Conversion of input data: coming from the network to Python data and types. Reading from:
+* 다음을 포함한 편집기 지원:
+ * 자동완성.
+ * 타입 검사.
+* 데이터 검증:
+ * 데이터가 유효하지 않을 때 자동으로 생성하는 명확한 에러.
+ * 중첩된 JSON 객체에 대한 유효성 검사.
+* 입력 데이터 변환: 네트워크에서 파이썬 데이터 및 타입으로 전송. 읽을 수 있는 것들:
* JSON.
- * Path parameters.
- * Query parameters.
- * Cookies.
- * Headers.
- * Forms.
- * Files.
-* Conversion of output data: converting from Python data and types to network data (as JSON):
- * Convert Python types (`str`, `int`, `float`, `bool`, `list`, etc).
- * `datetime` objects.
- * `UUID` objects.
- * Database models.
- * ...and many more.
-* Automatic interactive API documentation, including 2 alternative user interfaces:
+ * 경로 매개변수.
+ * 쿼리 매개변수.
+ * 쿠키.
+ * 헤더.
+ * 폼(Forms).
+ * 파일.
+* 출력 데이터 변환: 파이썬 데이터 및 타입을 네트워크 데이터로 전환(JSON 형식으로):
+ * 파이썬 타입 변환 (`str`, `int`, `float`, `bool`, `list`, 등).
+ * `datetime` 객체.
+ * `UUID` 객체.
+ * 데이터베이스 모델.
+ * ...더 많은 것들.
+* 대안가능한 사용자 인터페이스를 2개 포함한 자동 대화형 API 문서:
* Swagger UI.
* ReDoc.
---
-Coming back to the previous code example, **FastAPI** will:
-
-* Validate that there is an `item_id` in the path for `GET` and `PUT` requests.
-* Validate that the `item_id` is of type `int` for `GET` and `PUT` requests.
- * If it is not, the client will see a useful, clear error.
-* Check if there is an optional query parameter named `q` (as in `http://127.0.0.1:8000/items/foo?q=somequery`) for `GET` requests.
- * As the `q` parameter is declared with `= None`, it is optional.
- * Without the `None` it would be required (as is the body in the case with `PUT`).
-* For `PUT` requests to `/items/{item_id}`, Read the body as JSON:
- * Check that it has a required attribute `name` that should be a `str`.
- * Check that it has a required attribute `price` that has to be a `float`.
- * Check that it has an optional attribute `is_offer`, that should be a `bool`, if present.
- * All this would also work for deeply nested JSON objects.
-* Convert from and to JSON automatically.
-* Document everything with OpenAPI, that can be used by:
- * Interactive documentation systems.
- * Automatic client code generation systems, for many languages.
-* Provide 2 interactive documentation web interfaces directly.
+이전 코드 예제로 돌아가서, **FastAPI**는 다음처럼 처리합니다:
+
+* `GET` 및 `PUT` 요청에 `item_id`가 경로에 있는지 검증.
+* `GET` 및 `PUT` 요청에 `item_id`가 `int` 타입인지 검증.
+ * 그렇지 않다면 클라이언트는 유용하고 명확한 에러를 볼 수 있습니다.
+* `GET` 요청에 `q`라는 선택적인 쿼리 매개변수가 검사(`http://127.0.0.1:8000/items/foo?q=somequery`처럼).
+ * `q` 매개변수는 `= None`으로 선언되었기 때문에 선택사항입니다.
+ * `None`이 없다면 필수사항입니다(`PUT`의 경우와 마찬가지로).
+* `/items/{item_id}`으로의 `PUT` 요청은 본문을 JSON으로 읽음:
+ * `name`을 필수 속성으로 갖고 `str` 형인지 검사.
+ * `price`을 필수 속성으로 갖고 `float` 형인지 검사.
+ * 만약 주어진다면, `is_offer`를 선택 속성으로 갖고 `bool` 형인지 검사.
+ * 이 모든 것은 깊이 중첩된 JSON 객체에도 적용됩니다.
+* JSON으로, 그리고 에서부터 자동 변환.
+* 다음에서 사용할 수 있는 모든 것을 OpenAPI로 문서화:
+ * 대화형 문서 시스템.
+ * 여러 언어들에 대한 자동 클라이언트 코드 생성 시스템.
+* 2개의 대화형 문서 웹 인터페이스를 직접 제공.
---
-We just scratched the surface, but you already get the idea of how it all works.
+우리는 그저 수박 겉핡기만 했을 뿐인데 여러분은 벌써 어떻게 작동하는지 알고 있습니다.
-Try changing the line with:
+다음 줄을 바꿔보세요:
```Python
return {"item_name": item.name, "item_id": item_id}
```
-...from:
+...에서:
```Python
... "item_name": item.name ...
```
-...to:
+...으로:
```Python
... "item_price": item.price ...
```
-...and see how your editor will auto-complete the attributes and know their types:
+...그러고 나서 여러분의 편집기가 속성과 타입을 알고 자동 완성하는지 보세요:
-For a more complete example including more features, see the Tutorial - User Guide.
+더 많은 기능을 포함한 보다 완전한 예제의 경우, 튜토리얼 - 사용자 가이드를 보세요.
-**Spoiler alert**: the tutorial - user guide includes:
+**스포일러 주의**: 튜토리얼 - 사용자 가이드는:
-* Declaration of **parameters** from other different places as: **headers**, **cookies**, **form fields** and **files**.
-* How to set **validation constraints** as `maximum_length` or `regex`.
-* A very powerful and easy to use **Dependency Injection** system.
-* Security and authentication, including support for **OAuth2** with **JWT tokens** and **HTTP Basic** auth.
-* More advanced (but equally easy) techniques for declaring **deeply nested JSON models** (thanks to Pydantic).
-* Many extra features (thanks to Starlette) as:
- * **WebSockets**
+* 서로 다른 장소에서 **매개변수** 선언: **헤더**, **쿠키**, **폼 필드** 그리고 **파일**.
+* `maximum_length` 또는 `regex`처럼 **유효성 제약**하는 방법.
+* 강력하고 사용하기 쉬운 **의존성 주입** 시스템.
+* **OAuth2** 지원을 포함한 **JWT tokens** 및 **HTTP Basic**을 갖는 보안과 인증.
+* (Pydantic 덕분에) **깊은 중첩 JSON 모델**을 선언하는데 더 진보한 (하지만 마찬가지로 쉬운) 기술.
+* (Starlette 덕분에) 많은 추가 기능:
+ * **웹 소켓**
* **GraphQL**
- * extremely easy tests based on `requests` and `pytest`
+ * `requests` 및 `pytest`에 기반한 극히 쉬운 테스트
* **CORS**
- * **Cookie Sessions**
- * ...and more.
+ * **쿠키 세션**
+ * ...기타 등등.
-## Performance
+## 성능
-Independent TechEmpower benchmarks show **FastAPI** applications running under Uvicorn as one of the fastest Python frameworks available, only below Starlette and Uvicorn themselves (used internally by FastAPI). (*)
+독립된 TechEmpower 벤치마크에서 Uvicorn에서 작동하는 FastAPI 어플리케이션이 사용 가능한 가장 빠른 프레임워크 중 하나로 Starlette와 Uvicorn(FastAPI에서 내부적으로 사용)에만 밑돌고 있습니다. (*)
-To understand more about it, see the section Benchmarks.
+자세한 내용은 벤치마크 섹션을 보세요.
-## Optional Dependencies
+## 선택가능한 종속사항
-Used by Pydantic:
+Pydantic이 사용하는:
-* ujson - for faster JSON "parsing".
-* email_validator - for email validation.
+* ujson - 더 빠른 JSON "파싱".
+* email_validator - 이메일 유효성 검사.
-Used by Starlette:
+Starlette이 사용하는:
-* requests - Required if you want to use the `TestClient`.
-* aiofiles - Required if you want to use `FileResponse` or `StaticFiles`.
-* jinja2 - Required if you want to use the default template configuration.
-* python-multipart - Required if you want to support form "parsing", with `request.form()`.
-* itsdangerous - Required for `SessionMiddleware` support.
-* pyyaml - Required for Starlette's `SchemaGenerator` support (you probably don't need it with FastAPI).
-* graphene - Required for `GraphQLApp` support.
-* ujson - Required if you want to use `UJSONResponse`.
+* requests - `TestClient`를 사용하려면 필요.
+* aiofiles - `FileResponse` 또는 `StaticFiles`를 사용하려면 필요.
+* jinja2 - 기본 템플릿 설정을 사용하려면 필요.
+* python-multipart - `request.form()`과 함께 "parsing"의 지원을 원하면 필요.
+* itsdangerous - `SessionMiddleware` 지원을 위해 필요.
+* pyyaml - Starlette의 `SchemaGenerator` 지원을 위해 필요 (FastAPI와 쓸때는 필요가 없을 겁니다).
+* graphene - `GraphQLApp` 지원을 위해 필요.
+* ujson - `UJSONResponse`를 사용하려면 필요.
-Used by FastAPI / Starlette:
+FastAPI / Starlette이 사용하는:
-* uvicorn - for the server that loads and serves your application.
-* orjson - Required if you want to use `ORJSONResponse`.
+* uvicorn - 애플리케이션을 로드하고 제공하는 서버.
+* orjson - `ORJSONResponse`을 사용하려면 필요.
-You can install all of these with `pip install fastapi[all]`.
+`pip install fastapi[all]`를 통해 이 모두를 설치 할 수 있습니다.
-## License
+## 라이센스
-This project is licensed under the terms of the MIT license.
+이 프로젝트는 MIT 라이센스 조약에 따라 라이센스가 부여됩니다.