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

백엔드 개발을 하다 보면 반드시 접하게 되는 두 가지 용어는 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)에 도달하기 전에 요청을 처리합니다.
• 요청이나 응답을 수정할 수 있습니다.
• 인증, 로깅, 유효성 검사 또는 오류 처리와 같은 작업에 자주 사용됩니다.

실제 비유

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

승인된 개인(유효한 요청)만이 사무실(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와 미들웨어의 주요 차이점

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에는 다음이 포함될 수 있습니다.

• /drivers: 사용 가능한 드라이버를 가져옵니다.
• /trips: 여행을 예약하거나 관리합니다.

미들웨어는 이면에서 다음을 보장합니다.

• 인증된 사용자만 /trips에 액세스할 수 있습니다.
• 모든 요청에 ​​대해 로그가 보관됩니다.
• 악용을 방지하기 위해 속도 제한이 적용됩니다.

강력한 애플리케이션을 만드는 데에는 API와 미들웨어가 모두 필수입니다. 하나는 기능을 노출하고 다른 하나는 원활하고 안전하게 작동하도록 보장합니다.

API에 관해 말하면,

저는 LiveAPI라는 매우 편리한 도구를 개발해왔습니다.

개발자가 쉽게 API 문서를 작성할 수 있도록 설계되었습니다.

LiveAPI를 사용하면 사용자가 브라우저에서 직접 API를 실행할 수 있는 대화형 API 문서를 빠르게 생성할 수 있습니다.

수동으로 문서를 만드는 데 지쳤거나 API용 Swagger를 통합하는 데 시간을 보내고 싶지 않다면 이 도구를 사용하면 작업이 더 쉬워질 수 있습니다. 지금 LiveAPI를 사용해 보세요!

위 내용은 API와 미들웨어: 차이점 이해의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!