이 강의에서는 API의 심화 개념을 배우고, 실제 서비스를 구축하는 실습을 진행합니다.이론과 실습을 병행하여, API를 실제 프로젝트에서 어떻게 활용하는지 익힐 수 있도록 구성하였습니다. API 기본개념에 대해 아직 모르시는 분들은 api 기본 개념에 관한 내용을 글을 확인 후 진행해보시길 바랍니다.

API 심화 개념 – 서비스 구축을 위한 핵심 개념

1. API 심화 개념 – 서비스 구축을 위한 핵심 개념

1-1. API의 종류 및 실전 활용법

API는 목적과 기능에 따라 여러 가지 유형이 있습니다.
각각의 API가 어떻게 사용되는지 이해하고, 실전 프로젝트에서 적절한 API를 선택하는 것이 중요합니다.

1. REST API (Representational State Transfer)

• 가장 널리 사용되는 API 구조입니다.
• HTTP 요청을 사용하여 클라이언트와 서버가 데이터를 주고받습니다.
• 특징: 경량, 표준화, 다양한 클라이언트 지원
• 예제:
  • GET /users/1 → 특정 사용자의 정보를 가져오기
  • POST /reviews → 새로운 리뷰 추가하기

2. GraphQL API

• 클라이언트가 원하는 데이터만 요청할 수 있습니다.
• 특징: REST보다 유연하고, 불필요한 데이터 호출을 방지할 수 있습니다.
• 예제:

{
  user(id: "1") {
    name
    email
    reviews {
      title
      rating
    }
  }
}

3. WebSocket API

• 실시간 데이터 통신이 필요한 경우 적합합니다. (예: 채팅, 실시간 알림)
• 특징: 지속적인 연결을 유지하여 빠른 응답을 제공합니다.
• 예제: 실시간 리뷰 업데이트 기능 구현

4. Open API (공개 API)

• 누구나 사용할 수 있도록 제공되는 API입니다.
• 예제:
  • TMDB API (영화 & 드라마 데이터 제공)
  • OpenWeather API (날씨 정보 제공)
  • ChatGPT API (AI 텍스트 생성 API)
• 1-2. API 인증(Authentication)과 보안(Security)
• API는 보안이 중요합니다.
• 허가되지 않은 사용자가 데이터를 조작하거나 가져가지 못하도록 보호해야 합니다.
• 1. API 인증 방식
• API Key (간단한 방식)
  • 사용자가 API 키를 요청할 때, API 요청 헤더에 포함해야 합니다.
  • 예제: Authorization: Bearer YOUR_API_KEY
• OAuth 2.0 (SNS 로그인, 권한 관리)
  • Google, Facebook 로그인 등에서 사용됩니다.
  • Access Token을 발급받아 인증하는 방식입니다.
• JWT (JSON Web Token) – 보안 강화
  • 클라이언트가 로그인하면 서버가 JWT를 발급하고,
  • 이후 요청 시 JWT를 포함하여 인증합니다.
• 2. API 보안 강화 방법
• HTTPS 사용 (SSL/TLS 암호화)
• API 요청 제한 (Rate Limiting)
• CORS 설정 (Cross-Origin Resource Sharing)

2. API 실습 – 실제 서비스 구축

실습 프로젝트: “슬픈 드라마 추천 API 만들기”

2-1. 프로젝트 목표 및 서비스 흐름

프로젝트 목표

• 사용자가 슬픈 드라마 리뷰를 남기면 API가 데이터를 저장
• API가 AI 분석을 통해 슬픈 드라마를 추천
• API를 활용하여 웹사이트에서 추천 결과를 표시

서비스 흐름

1. 사용자가 리뷰를 남김 → API가 DB에 저장
2. API가 사용자의 감성 분석 (AI 활용)
3. API가 DB에서 비슷한 감성의 드라마 추천
4. API가 추천된 드라마를 웹사이트로 반환

3. 실습 1: API 설계 및 데이터 모델링

3-1. API 설계 (엔드포인트 정의)

HTTP 메서드	엔드포인트	설명
POST	/reviews	사용자 리뷰 추가
GET	/reviews/{drama}	특정 드라마의 리뷰 가져오기
GET	/recommend/{user}	사용자 맞춤형 슬픈 드라마 추천

3-2. 데이터 모델 설계

DB 테이블 구조 (PostgreSQL 기준)

ID	사용자	드라마 제목	감성 점수 (0~1)	리뷰 내용
1	content	나의 아저씨	0.9	감동적인 드라마였어요 ㅠㅠ
2	flow	미스터 션샤인	0.85	눈물 없이는 못 봅니다…

4. 실습 2: FastAPI를 활용한 API 구축

4-1. FastAPI 설치 및 기본 설정

bash 예제 코드

pip install fastapi uvicorn psycopg2

4-2. API 기본 코드 작성

python 예제 코드

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Review(BaseModel):
    user: str
    drama: str
    rating: int
    review: str

@app.post("/reviews")
def add_review(review: Review):
    return {"message": f"{review.drama}에 대한 리뷰가 저장되었습니다!"}

4-3. 실행 및 테스트

bash 예제 코드

uvicorn main:app --reload

API 호출 예제 (POST 요청)

http 예제코드

POST /reviews
{
    "user": "content",
    "drama": "나의 아저씨",
    "rating": 5,
    "review": "정말 감동적이었어요!"
}

5. 실습 3: AI 감성 분석 & 추천 기능 추가

5-1. 감성 분석 API 연동

python 예제 코드

from transformers import pipeline

emotion_model = pipeline("text-classification", model="j-hartmann/emotion-english-distilroberta-base")

def analyze_emotion(text):
    result = emotion_model(text)
    return result[0]["score"] if result[0]["label"] == "sadness" else 0.0

5-2. AI 추천 시스템 구현

python 예제 코드

@app.get("/recommend/{user}")
def recommend_drama(user: str):
    # 슬픈 감성 점수가 높은 드라마 추천
    return {"recommended": ["나의 아저씨", "미스터 션샤인"]}

API 요청 & 응답 예제
http 예제 코드

GET /recommend/content
{
    "recommended": ["나의 아저씨", "미스터 션샤인"]
}

6. API 배포 및 웹사이트 연동 – 실전 적용하기

이제 우리가 만든 FastAPI 기반의 API를 실제 서버에 배포하고, React 웹사이트에서 호출하는 방법을 배워보겠습니다.
배포 후 API가 정상적으로 작동하는지 테스트하고, 성능을 최적화하는 과정까지 진행합니다.

6-1. FastAPI 배포 (AWS, Vercel, Heroku 활용)

FastAPI로 만든 API를 배포하여 누구나 사용할 수 있도록 웹 서버에서 실행해야 합니다.
배포할 수 있는 대표적인 방법은 AWS, Vercel, Heroku 등이 있습니다.

FastAPI 배포를 위한 필수 개념

1. 서버 실행 방식: FastAPI는 로컬 개발 환경에서는 uvicorn을 사용하지만,
   배포 시에는 gunicorn과 같은 WSGI 서버를 사용해야 합니다.
2. 클라우드 서버 선택: AWS, Vercel, Heroku 등의 플랫폼을 선택해야 합니다.
3. 도메인 연결: 배포된 API가 http://localhost:8000이 아니라,
   https://myapi.com 같은 도메인에서 동작하도록 설정합니다.

방법 1: AWS EC2로 배포하기

AWS EC2(Elastic Compute Cloud)는 클라우드에서 가상 서버를 제공하여 API를 배포할 수 있도록 합니다.

1. EC2 인스턴스 생성

1. AWS 콘솔에서 EC2 인스턴스를 생성합니다.
2. Ubuntu 20.04 또는 Amazon Linux 선택
3. 최소 사양: t2.micro (무료)

2. EC2에 FastAPI 배포하기

EC2 인스턴스에 SSH로 접속 아래 코드 실행

ssh -i your-key.pem ubuntu@your-ec2-ip

Python 및 패키지 설치

sudo apt update && sudo apt upgrade -y
sudo apt install python3-pip -y
pip3 install fastapi uvicorn

API 실행

uvicorn main:app --host 0.0.0.0 --port 8000

방화벽 설정

• AWS 보안 그룹에서 포트 8000을 열어야 합니다.
• http://your-ec2-ip:8000/docs 에서 API가 작동하는지 확인합니다.

3. Nginx & Gunicorn으로 배포 최적화

3-1. Gunicorn 설치 및 실행

pip install gunicorn
gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app

3-2. Nginx 설정 (Reverse Proxy)

sudo apt install nginx -y
sudo nano /etc/nginx/sites-available/api

nginx복사편집server {
    listen 80;
    server_name your-api.com;
    
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3-3. Nginx 적용 후 서비스 시작

sudo ln -s /etc/nginx/sites-available/api /etc/nginx/sites-enabled
sudo systemctl restart nginx

3-4. 도메인 연결 및 SSL 인증서 적용

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-api.com

이제 https://your-api.com 에서 FastAPI를 사용할 수 있습니다!

방법 2: Vercel로 배포하기

Vercel은 무료로 FastAPI 애플리케이션을 배포할 수 있는 서비스입니다.

1. Vercel 계정 생성 후 CLI 설치

npm install -g vercel
vercel login

2. FastAPI 프로젝트를 Vercel에 연결 후 배포

vercel

이제 https://your-api.vercel.app에서 API를 사용할 수 있습니다.

방법 3: Heroku로 배포하기

Heroku는 간단하게 API를 배포할 수 있는 클라우드 서비스입니다.

1. Heroku CLI 설치

curl https://cli-assets.heroku.com/install.sh | sh
heroku login

2. FastAPI 프로젝트를 Heroku에 배포

heroku create your-api-name
git push heroku main

이제 https://your-api.herokuapp.com 에서 API를 사용할 수 있습니다.

6-2. React 웹사이트에서 API 호출하여 결과 표시

FastAPI로 배포한 API를 React 웹사이트에서 호출하여 데이터를 가져오는 방법을 배워보겠습니다.

1. React 프로젝트 설정

npx create-react-app my-app
cd my-app
npm start

2. React에서 API 호출 (useEffect + fetch 사용)

javascript

import { useEffect, useState } from "react";

function App() {
    const [data, setData] = useState([]);

    useEffect(() => {
        fetch("https://your-api.com/recommend/content")
            .then(response => response.json())
            .then(result => setData(result.recommended));
    }, []);

    return (
        <div>
            <h1>추천 드라마</h1>
            <ul>
                {data.map((drama, index) => (
                    <li key={index}>{drama}</li>
                ))}
            </ul>
        </div>
    );
}

export default App;

3. CORS 설정 (FastAPI에서 React 요청 허용하기)

FastAPI는 기본적으로 보안상 CORS 요청을 막습니다.

React에서 API를 정상적으로 호출하려면, FastAPI에서 CORS 설정을 추가해야 합니다.

from fastapi.middleware.cors import CORSMiddleware

app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],  # 특정 도메인만 허용 가능
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

이제 React에서 API를 정상적으로 호출할 수 있습니다.

6-3. 테스트 및 최적화 진행

API가 정상적으로 배포되었는지 확인하고, 성능을 최적화하는 과정입니다.

1. API 테스트 도구 활용하기

• Postman: API 요청을 직접 보내서 응답 확인
• cURL: 터미널에서 API 호출 테스트

curl -X GET "https://your-api.com/recommend/content

• FastAPI 내장 /docs 활용:
  • https://your-api.com/docs 에서 API 자동 문서 확인

2. API 응답 속도 최적화

• Redis 캐싱 적용: 자주 요청되는 데이터를 Redis에 저장
• 데이터베이스 인덱싱: SQL에서 인덱스 추가하여 검색 속도 향상
• Gunicorn + Nginx 조합: 고성능 웹 서버 설정

3. 로깅 및 모니터링 추가

• FastAPI에서 logging을 사용하여 API 호출 로그 저장
• AWS CloudWatch, Grafana 등의 모니터링 도구 연동

7. 최종 프로젝트 정리

• API를 활용하여 사용자 리뷰를 DB에 저장
• AI를 활용하여 감성 분석 후 슬픈 드라마 추천
• 웹사이트에서 API를 호출하여 추천 결과 표시

8. 실전 학습으로 만들어볼 수 있는 프로젝트 응용 아이디어

• AI 기반 뉴스 요약 API
• 실시간 채팅 API (WebSocket 활용)
• SNS 로그인 API (OAuth 2.0 활용)

주요 기술 개념 정리 (Nginx, Gunicorn, Vercel, Heroku, React, CORS, FastAPI)

용어	설명	주요 역할	활용 예제
Nginx	웹 서버이자 리버스 프록시 서버	정적 파일 서빙, 로드 밸런싱, 보안 강화	웹사이트 트래픽 분산, API 서버 앞단에서 요청 관리
Gunicorn	Python WSGI 서버	FastAPI, Django, Flask 등의 애플리케이션을 실행	FastAPI 배포 시, gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app 사용
Vercel	클라우드 배포 플랫폼	정적 사이트 및 백엔드 서버 배포	React, Next.js, FastAPI 등의 무료 배포 지원
Heroku	PaaS(Platform as a Service)	코드만 업로드하면 자동으로 서버를 배포	git push heroku main으로 FastAPI 배포
React	프론트엔드 라이브러리	UI 구성 요소(Component) 기반으로 웹 앱 제작	useState, useEffect를 사용한 데이터 관리
CORS	보안 정책(교차 출처 요청 방지)	외부 도메인에서 API 요청을 할 수 있도록 허용	FastAPI에서 allow_origins=["*"] 설정 필요
FastAPI	Python 기반 웹 프레임워크	API 개발을 쉽고 빠르게 구현	@app.get("/") 로 API 라우팅 가능

현재 서비스 되고 있는 ai 를 이용시다보면 api 를 이용해보실텐데요. api 를 사용하기전 api를 조금 더 잘 활용하려면 api 가 어떤 역할을 하는지, api 의 기본 개념을 확인해보신다면 큰 도움이 되실겁니다.

이 글에서는 API와 데이터베이스(DB)의 개념을 쉽고 명확하게 설명합니다.
API는 데이터를 직접 저장하는 것이 아니라 “주고받는 역할”을 하며,
데이터를 영구적으로 보관하려면 데이터베이스(DB)와 연결해야 합니다.

1. API는 데이터를 보관하는 게 아니라 “주고받는 역할”을 한다!

API는 일종의 데이터 통로(메신저)입니다. 쉽게 말해, 즉, 데이터를 클라이언트(웹사이트, 앱)와 서버(백엔드) 간에 주고받는 역할을 합니다.

📌 예제 상황 (드라마 리뷰 시스템)

API가 실제로 어떻게 동작하는지 이해하기 위해, “드라마 리뷰 시스템”을 예로 들어보겠습니다.

1️⃣ 사용자가 “나의 아저씨” 리뷰를 남긴다.
→ 사용자는 웹사이트에서 리뷰를 작성하고 제출 버튼을 누릅니다.

2️⃣ API가 사용자의 요청을 받아서 데이터베이스(DB)에 저장한다.
→ API가 데이터를 받아 서버의 DB에 저장합니다.

3️⃣ 다른 사용자가 “나의 아저씨 리뷰를 보여줘!” 요청한다.
→ API가 DB에서 해당 드라마 리뷰를 찾아 사용자에게 전달합니다.

4️⃣ 사용자는 리뷰 데이터를 확인한다.
→ API가 전달한 데이터를 웹사이트가 표시합니다.

📌 중요한 개념!

• ✅ API 자체는 데이터를 저장하지 않습니다!
• ✅ API는 데이터를 DB에서 가져오거나, DB에 넣는 역할만 합니다.
• ✅ 데이터를 계속 보관하려면 데이터베이스(DB)가 필요합니다!

API 자체는 데이터를 저장하지 않고, DB에서 가져오거나 넣는 역할만합니다. 데이터를 계속 보관하려면 DB(데이터베이스)가 필요합니다. DB 는 my sql 및 maria db 등이 주요로 사용되고 있습니다.

DB 는 데이터를 효율적으로 관리하면서 프로그램과 연동할 수 있도록 하는 저장소라고 보시면 됩니다. 저장소 관리 즉 DB 관리의 핵심은 sql 이라고 보시면 되는데, SQL은 관계형 데이터베이스와 비관계현 데이터베이스 2종류로 구분할 수 있습니다. 데이터베이스에 관한 내용은 아래에서 자세하게 살펴보도록 하겠습니다.

2. API + 데이터베이스(DB) 연결이 필요합니다.

API가 데이터를 제대로 주고받으려면, 반드시 데이터베이스(DB)와 연결해야 합니다. 이제 API와 DB가 함께 동작하는 원리를 이해해 봅시다.

API의 기본 역할 (요청 & 응답)

API 요청(Request) → “이 데이터를 DB에 저장해줘!”
API 응답(Response) → “이 데이터를 DB에서 가져와서 보여줄게!”

• ✅ 데이터 저장할 때 (사용자가 리뷰 남길 때) : API가 데이터를 받아서 DB에 저장
• ✅ 데이터 불러올 때 (사용자가 리뷰 볼 때) : API가 DB에서 데이터를 꺼내와서 사용자에게 전달함

예를들어 넷플릭스 리뷰를 작성할 경우 리뷰는 데이터 베이스에 저장되고, 사용자가 리뷰를 보려고할 대 데이터 베이스는 사용자에게 전달되어 다른 사용자들이 본 리뷰를 확인해볼 수 있습니다.

3. API가 데이터를 보관하는 게 아니라, DB가 데이터를 저장한다!

✔️ 핵심 개념: API는 데이터를 “이동”시키고, “보관”하는 것은 데이터베이스가 한다.

📌 만약 DB가 없으면?

• API가 데이터를 받아도 저장할 곳이 없으니 데이터가 사라져버립니다! 😱
• 예를 들어, 사용자가 리뷰를 남겼지만 DB가 없으면 새로고침하면 데이터가 날아갑니다.

📌 데이터를 계속 저장하려면?

• API는 단순한 “중간 역할”일 뿐, 데이터를 보관하는 기능이 없습니다.
• 데이터를 지속적으로 보관하려면 반드시 API + DB를 함께 사용해야 합니다.

4. 데이터베이스(DB)란?

데이터베이스(DB, Datebase) 는 데이터를 영구적으로 보관하는 저장소입니다.

• 네이버와 같은 웹사이트나 앱에서 본 모든 데이터(회원정보, 게시글, 댓글, 리뷰 등)는 DB에 저장되어 집니다.
• API는 이 DB에 데이터를 넣거나 가져오는 역할을합니다

• DB의 특징
  • ✅ 데이터를 영구적으로 보관할 수 있음
  • ✅ 많은 양의 데이터를 관리하기 용이함
  • ✅ 여러 사용자가 동시에 접근 가능함

📌 예시: 드라마 리뷰 데이터 베이스

ID	사용자	드라마 제목	별점	리뷰 내용
1	content	나의 아저씨	⭐⭐⭐⭐⭐	감동적인 드라마였어요 ㅠㅠ
2	flow	미스터 션샤인	⭐⭐⭐⭐☆	눈물 없이는 못 봅니다…

위에 내용처럼 사용자가 드라마 제목에 별점과 리뷰내용을 작성하면 AP RK 데이터베이스에 저장 한 후 나중에 다른 사용자들이 리뷰를 볼때 다시 불러 올 수 있도록 하는 역할을 합니다.