집 >웹 프론트엔드 >JS 튜토리얼 >API와 미들웨어: 차이점 이해

API와 미들웨어: 차이점 이해

DDD원래의: 2025-01-14 08:09:44671검색

백엔드 개발을 하다 보면 반드시 접하게 되는 두 가지 용어는 API와 미들웨어입니다.

두 가지 모두 애플리케이션 아키텍처에서 중요한 역할을 하지만 용도는 매우 다릅니다.

책상을 뒤집고 싶지 않을 정도로 세분화하여 역할을 비교하고 차이점을 명확히 하겠습니다.

API란 무엇입니까?

API는 애플리케이션 프로그래밍 인터페이스의 약자입니다. 이는 본질적으로 다양한 소프트웨어 구성 요소가 서로 통신할 수 있도록 하는 계약입니다.

레스토랑의 웨이터라고 생각해보세요. 주문(요청)을 받아 주방(서버)에 배달한 다음 음식을 가져옵니다(응답).

API의 주요 특징

데이터 또는 서비스와 상호작용하기 위해 엔드포인트를 노출합니다.
HTTP/HTTPS(웹 API에 가장 일반적임)를 통해 작동합니다.
REST, GraphQL, gRPC와 같은 프로토콜을 따를 수 있습니다.

실제 비유

Uber를 주문하거나 트윗을 게시할 때마다 API를 사용하고 있습니다. 앱의 백엔드는 프런트엔드에서 데이터를 가져오거나 보낼 수 있는 API를 제공합니다.

코드 예시 Express.js 앱에서 간단한 API 엔드포인트는 다음과 같습니다.

  const express = require('express');
  const app = express();

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });

API는 앱이 외부 세계에 노출하는 기능을 정의합니다.

API vs Middleware: Understanding the Difference

미들웨어란 무엇입니까?

미들웨어는 주방의 뒤에서 일하는 직원과 비슷합니다. 직접적으로 서비스를 제공하는 것은 아니지만 모든 일이 원활하게 진행되도록 보장합니다.

기술적인 측면에서 미들웨어는 애플리케이션 파이프라인의 요청과 응답 사이에 있는 기능 또는 기능 집합입니다.

미들웨어의 주요 특징

최종 처리기(예: API)에 도달하기 전에 요청을 처리합니다.
요청이나 응답을 수정할 수 있습니다.
인증, 로깅, 유효성 검사 또는 오류 처리와 같은 작업에 자주 사용됩니다.

실제 비유

미들웨어를 건물의 경비원이라고 생각해보세요.

승인된 개인(유효한 요청)만이 사무실(API)에 접근할 수 있도록 보장합니다.

코드 예시 Express.js의 간단한 로깅 미들웨어 예는 다음과 같습니다.

  const express = require('express');
  const app = express();

  const loggingMiddleware = (req, res, next) => {
    console.log(`Request made to: ${req.url}`);
    next(); // Pass control to the next middleware or handler
  };

  app.use(loggingMiddleware);

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });

미들웨어는 요청이 엔드포인트에 도달하기 전에 처리되는 방법을 처리합니다.

API vs Middleware: Understanding the Difference

API와 미들웨어의 주요 차이점

Aspect	API	Middleware
Purpose	Defines endpoints for interaction.	Processes requests/responses.
Visibility	Exposed to external systems.	Works internally within the app.
Examples	/users, /products, /login	Authentication, logging, error handling
Interaction	Invoked by external clients.	Invoked automatically in the request pipeline.
Code Placement	Found in controllers.	Found in the middleware functions.

API와 미들웨어를 사용해야 하는 경우

API
- 외부 애플리케이션이나 서비스가 시스템과 상호 작용할 수 있는 방법을 제공하려는 경우 API를 사용하세요.
- 예: /users/:id를 통해 사용자 세부정보를 가져오는 모바일 앱
미들웨어
- 여러 경로나 API에 적용되는 교차 문제에 미들웨어를 사용하세요.
- 예: 모든 보호된 경로에 대해 JWT 토큰 확인, 브라우저에서 쿠키 설정

API vs Middleware: Understanding the Difference