[파이썬] Flask를 이용한 RESTful API 개발

01 Sep 2023

Flask는 Python으로 작성된 마이크로 웹 프레임워크로, 간단하고 유연한 방식으로 RESTful API 개발을 지원합니다. 이 글에서는 Flask를 이용하여 어떻게 RESTful API를 개발할 수 있는지 알아보겠습니다.

RESTful API란?

RESTful API는 Representational State Transfer(표현 상태 전달)의 약자로, 웹 애플리케이션의 자원을 효율적으로 관리하고 통신하기 위한 아키텍처 스타일입니다. RESTful API의 특징은 다음과 같습니다.

자원 중심적: 서버에 있는 자원(예: 데이터베이스의 레코드)에 대한 전송과 상태 변화를 주로 다룹니다.
HTTP 메서드 사용: HTTP 프로토콜의 메서드(GET, POST, PUT, DELETE 등)를 이용하여 자원에 대한 행위를 표현합니다.
URI 사용: 각 자원은 고유한 URI(Uniform Resource Identifier)로 식별됩니다.
무상태성: 상태 정보를 서버에 저장하고 관리하지 않으므로, 요청마다 필요한 정보를 모두 담아 보내야 합니다.

Flask를 사용하기 위해서는 Flask 패키지를 먼저 설치해야 합니다. 아래 명령어를 터미널에서 실행하여 설치할 수 있습니다.

pip install Flask

from flask import Flask

app = Flask(__name__)

Flask는 데코레이터를 사용하여 URL 엔드포인트와 API 엔드포인트를 설정합니다. 예를 들어, 아래의 코드는 /api/user 엔드포인트에 GET 메서드로 접근할 수 있는 API 엔드포인트를 설정합니다.

@app.route('/api/user', methods=['GET'])
def get_user():
    return 'User API endpoint'

API 엔드포인트에서 필요한 로직을 구현합니다. 예를 들어, POST 메서드로 /api/user 엔드포인트에 요청이 들어오면 새로운 사용자를 생성하는 로직을 구현할 수 있습니다.

@app.route('/api/user', methods=['POST'])
def create_user():
    # User creation logic here
    return 'User created'

Flask 애플리케이션을 실행하기 위해 아래의 코드를 추가합니다.

if __name__ == '__main__':
    app.run()

서버를 실행하고, 웹 브라우저나 API 클라이언트를 통해 API 엔드포인트에 접근하여 테스트할 수 있습니다.

Flask를 이용하면 간단하고 유연한 방식으로 RESTful API를 개발할 수 있습니다. Flask의 뛰어난 확장성과 적은 코드 양은 개발자가 손쉽게 웹 애플리케이션을 제작하고 관리할 수 있도록 도와줍니다. Flask를 사용하여 RESTful API를 개발해보세요!