<div id="readability-page-1" class="page"><div><div aria-hidden="false"><a rel="noopener follow" href="/?source=post_page---byline--898895845adf---------------------------------------"><div><p><img alt="이상문" src="https://miro.medium.com/v2/resize:fill:64:64/1*PdFTYwkEj-ebxhH52VWJ8w.png" width="32" height="32" loading="lazy" data-testid="authorPhoto"></p></div></a></div><p id="3c24"><strong>FastAPI</strong>는 Python으로 빠르고 효율적인 웹 API를 만들 수 있게 도와주는 현대적인 웹 프레임워크이다. 비동기 처리를 기본 지원하며, 자동 문서화 기능과 간결한 코드 구조 덕분에 많은 개발자들이 선호할 만하다. 이 글에서는 FastAPI를 시작하는 방법부터 요청 처리 방식, 그리고 실행을 위한 uvicorn의 역할까지 핵심 내용을 정리한다.</p><h2 id="afa1">1. FastAPI 설치</h2><pre><span id="771b">pip install fastapi uvicorn</span></pre><ul><li id="03ae"><code>fastapi</code>: API를 만들기 위한 핵심 프레임워크</li><li id="7c0a"><code>uvicorn</code>: FastAPI 애플리케이션을 실행하기 위한 고성능 ASGI 서버</li></ul><h2 id="e41f">2. 가장 간단한 FastAPI 예제</h2><pre><span id="b9e4"># main.py<br>from fastapi import FastAPI<p>app = FastAPI()<br>@app.get("/")<br>def read_root():<br>    return {"message": "Hello, FastAPI!"}</p></span></pre><h2 id="6869">요청 처리 기능 정의 방법</h2><p id="688d">FastAPI에서는 HTTP 요청을 처리하는 함수를 데코레이터로 정의한다.</p><h2 id="3951">1. GET 요청 처리</h2><pre><span id="3b90">@app.get("/hello")<br>def say_hello():<br>    return {"message": "Hi there!"}</span></pre><h2 id="cc3f">2. 경로 매개변수 (Path Parameter)</h2><pre><span id="a91b">@app.get("/items/{item_id}")<br>def read_item(item_id: int):<br>    return {"item_id": item_id}</span></pre><h2 id="52c2">3. 쿼리 매개변수 (Query Parameter)</h2><pre><span id="34e0">@app.get("/search")<br>def search_items(keyword: str = ""):<br>    return {"keyword": keyword}</span></pre><h2 id="4cbc">4. POST 요청과 JSON 본문 처리</h2><pre><span id="2de6">from pydantic import BaseModel<p>class Item(BaseModel):<br>    name: str<br>    price: float<br>@app.post("/items")<br>def create_item(item: Item):<br>    return {"received": item}</p></span></pre><h2 id="fea3">FastAPI 실행을 위한 uvicorn 사용 이유와 효과</h2><p id="b5e8">FastAPI 애플리케이션은 단독으로 실행되지 않으며, 실행을 위해 <strong>ASGI 서버</strong>가 필요하다. 여기서 <strong>uvicorn</strong>이 사용된다.</p><blockquote><p id="b535"><strong><em>ASGI (Asynchronous Server Gateway Interface)</em></strong><em>는 Python 웹 프레임워크가 비동기적으로 동작할 수 있게 해주는 표준 인터페이스이다. FastAPI는 ASGI 기반 프레임워크이기 때문에 ASGI 서버를 통해 실행되어야 한다.</em></p></blockquote><h2 id="7077">1. uvicorn 실행 방법</h2><pre><span id="cba6">uvicorn main:app --reload</span></pre><ul><li id="aeb4"><code>main</code>: Python 파일 이름 (main.py)</li><li id="f4d5"><code>app</code>: FastAPI 인스턴스 이름</li><li id="046e"><code>--reload</code>: 코드 변경 시 서버 자동 재시작 (개발 중에 유용)</li></ul></div></div>

Stories by 이상문 on Medium

FastAPI는 Python으로 빠르고 효율적인 웹 API를 만들 수 있게 도와주는 현대적인 웹 프레임워크이다. 비동기 처리를 기본 지원하며, 자동 문서화 기능과 간결한 코드 구조 덕분에 많은 개발자들이 선호할 만하다. 이 글에서는 FastAPI를 시작하는 방법부터 요청 처리 방식, 그리고 실행을 위한 uvicorn의 역할까지 핵심 내용을 정리한다.
1. FastAPI 설치
pip install fastapi uvicorn
fastapi: API를 만들기 위한 핵심 프레임워크
uvicorn: FastAPI 애플리케이션을 실행하기 위한 고성능 ASGI 서버
2. 가장 간단한 FastAPI 예제
# main.py
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI!"}
요청 처리 기능 정의 방법
FastAPI에서는 HTTP 요청을 처리하는 함수를 데코레이터로 정의한다.
1. GET 요청 처리
@app.get("/hello")
def say_hello():
    return {"message": "Hi there!"}
2. 경로 매개변수 (Path Parameter)
@app.get("/items/{item_id}")
def read_item(item_id: int):
    return {"item_id": item_id}
3. 쿼리 매개변수 (Query Parameter)
@app.get("/search")
def search_items(keyword: str = ""):
    return {"keyword": keyword}
4. POST 요청과 JSON 본문 처리
from pydantic import BaseModel
class Item(BaseModel):
    name: str
    price: float
@app.post("/items")
def create_item(item: Item):
    return {"received": item}
FastAPI 실행을 위한 uvicorn 사용 이유와 효과
FastAPI 애플리케이션은 단독으로 실행되지 않으며, 실행을 위해 ASGI 서버가 필요하다. 여기서 uvicorn이 사용된다.
ASGI (Asynchronous Server Gateway Interface)는 Python 웹 프레임워크가 비동기적으로 동작할 수 있게 해주는 표준 인터페이스이다. FastAPI는 ASGI 기반 프레임워크이기 때문에 ASGI 서버를 통해 실행되어야 한다.
1. uvicorn 실행 방법
uvicorn main:app --reload
main: Python 파일 이름 (main.py)
app: FastAPI 인스턴스 이름
--reload: 코드 변경 시 서버 자동 재시작 (개발 중에 유용)

FastAPI로 API 만들기: 시작, 요청 처리, 실행까지 한눈에 이해하기

댓글