网页 综合 更新时间 2026-11-14 05:19:12

FastAPI - FastAPI

自动蜘蛛 fastapi.tiangolo.com 正文约 2121 字
이 번역은 사람의 안내를 받아 AI가 만들었습니다. 🤝
원문의 의미를 오해하거나 부자연스러워 보이는 등 오류가 있을 수 있습니다. 🤖
AI LLM을 더 잘 안내하는 데 도움을 주세요.
FastAPI 프레임워크, 고성능, 간편한 학습, 빠른 코드 작성, 준비된 프로덕션
문서: https://fastapi.tiangolo.com/ko
소스 코드: https://github.com/fastapi/fastapi
FastAPI는 현대적이고, 빠르며(고성능), 파이썬 표준 타입 힌트에 기초한 Python의 API를 빌드하기 위한 웹 프레임워크입니다.
Use the official FastAPI skill for your installed version. Install it from your project directory:
See Develop with AI.
* 내부 개발팀의 프로덕션 애플리케이션을 빌드한 테스트에 근거한 측정
"[...] 저는 요즘 FastAPI를 많이 사용하고 있습니다. [...] 사실 우리 팀의 마이크로소프트 ML 서비스 전부에 사용할 계획입니다. 그중 일부는 핵심 Windows 제품과 일부 Office 제품에 통합되고 있습니다."
"FastAPI 라이브러리를 채택하여 예측을 얻기 위해 쿼리를 실행할 수 있는 REST 서버를 생성했습니다. [Ludwig을 위해]"
"Netflix는 우리의 위기 관리 오케스트레이션 프레임워크인 Dispatch의 오픈 소스 공개를 발표하게 되어 기쁩니다! [FastAPI로 빌드]"
"프로덕션 Python API를 만들고자 한다면, 저는 FastAPI를 강력히 추천합니다. 아름답게 설계되었고, 사용이 간단하며, 확장성이 매우 뛰어나 우리의 API 우선 개발 전략에서 핵심 구성 요소가 되었고, 우리의 Virtual TAC Engineer와 같은 여러 자동화와 서비스들을 추진하고 있습니다."
2025년 말에 공개된 FastAPI 미니 다큐멘터리가 있습니다. 온라인에서 시청할 수 있습니다:
웹 API 대신 터미널에서 사용할 CLI 애플리케이션을 만들고 있다면, Typer를 확인해 보십시오.
Typer는 FastAPI의 동생입니다. 그리고 CLI를 위한 FastAPI가 되기 위해 생겼습니다. ⌨️ 🚀
FastAPI는 거인들의 어깨 위에 서 있습니다:
먼저, uv를 설치한 다음 프로젝트에 FastAPI를 추가하세요:
참고: 모든 터미널에서 동작하도록 "fastapi[standard]"를 따옴표로 감싸 넣었는지 확인하세요.
pip를 사용하는 것을 선호한다면, 가상 환경 안에 fastapi[standard]를 설치하세요. 대안 단계는 설치 가이드를 참고하세요.
다음 내용으로 main.py 파일을 만드십시오:
여러분의 코드가 async / await을 사용한다면, async def를 사용하십시오:
잘 모르겠다면, 문서의 async와 await에 관한 "급하세요?" 섹션을 확인해 보십시오.
fastapi dev 명령어는 여러분의 main.py 파일을 자동으로 읽고, 그 안의 FastAPI 애플리케이션을 감지한 다음, Uvicorn을 사용해 서버를 시작합니다.
기본적으로 fastapi dev는 로컬 개발을 위해 auto-reload가 활성화된 상태로 시작됩니다.
자세한 내용은 FastAPI CLI 문서에서 확인할 수 있습니다.
브라우저로 http://127.0.0.1:8000/items/5?q=somequery를 열어보십시오.
아래의 JSON 응답을 볼 수 있습니다:
여러분은 벌써 API를 만들었습니다:
이제 http://127.0.0.1:8000/docs로 가보십시오.
자동 대화형 API 문서를 볼 수 있습니다 (Swagger UI 제공):
그리고 이제 http://127.0.0.1:8000/redoc로 가봅시다.
다른 자동 문서를 볼 수 있습니다(ReDoc 제공):
이제 PUT 요청에서 본문을 받기 위해 main.py 파일을 수정해봅시다.
Pydantic 덕분에 표준 Python 타입을 사용해 본문을 선언합니다.
fastapi dev 서버는 자동으로 리로딩되어야 합니다.
이제 http://127.0.0.1:8000/docs로 이동합니다.
그리고 이제, http://127.0.0.1:8000/redoc로 이동합니다.
요약하면, 여러분은 매개변수의 타입, 본문 등을 함수 매개변수로서 한번에 선언했습니다.
访问原文 返回搜索 https://fastapi.tiangolo.com/ko/
本页为82搜索生成的网页快照,内容来自站内索引;演示数据的原文链接仅作示例。