API 작업하기
Node.js Express로 쉽게 서버 구축하기
API와 함께 작업하기
이번 장에서는 Node.js와 Express를 사용하여 API를 개발하는 방법에 대해 알아보겠습니다. API(Application Programming Interface)는 데이터 통신을 위한 규칙과 도구의 집합으로, 현대 웹 및 모바일 애플리케이션의 핵심 구성 요소입니다. Express는 간단하고 효율적인 API 개발을 지원하며, TypeScript를 사용하면 코드의 안전성과 유지 관리성을 더욱 향상시킬 수 있습니다.
API란 무엇인가요?
API는 서로 다른 소프트웨어들이 상호 작용할 수 있도록 하는 인터페이스입니다. 예를 들어, 클라이언트 애플리케이션이 서버로 데이터를 요청하면 서버는 요청에 따른 데이터를 클라이언트에게 제공합니다. 이때, 클라이언트와 서버 간의 데이터 교환을 API를 통해 조율합니다.
Express로 API 구축하기
먼저, HTTP 요청을 처리하는 간단한 API를 만들어 봅시다. 이 API는 사용자 데이터 목록을 반환하는 역할을 합니다.
1. Node.js와 Express 프로젝터 초기화
이전 장에서 다룬 방법대로 프로젝트를 초기화하고 필요한 라이브러리를 설치합니다.
2. Express 서버 코드 작성하기
다음은 RESTful GET API를 정의한 코드 예제입니다:
import express from 'express';
const app = express();
const port = 3000;
const users = [
{ id: 1, name: "Alice" },
{ id: 2, name: "Bob" }
];
app.get('/api/users', (req, res) => {
res.json(users);
});
app.listen(port, () => {
console.log(`Server is running on http://localhost:${port}`);
});
3. 실행 및 테스트
터미널에서 서버를 실행합니다:
npx ts-node server.ts
브라우저에서 http://localhost:3000/api/users
로 접속하면 JSON 형식의 유저 데이터를 확인할 수 있습니다.
요약
이번 장에서는 Node.js와 Express, 그리고 RESTful API의 기본 개념을 정리하고, 간단한 API 서버를 만들어 보았습니다. 이러한 API는 보다 복잡한 애플리케이션을 구성하는 데 필수적입니다. 다음 장에서 더욱 고급 기능인 미들웨어와 데이터베이스 연동 등을 다루어 보겠습니다.
참고 자료
[Node.js+Express] Express로 REST API를 개발해보자(1) - 벨로그](https://velog.io/@paul7/Node.jsExpress-Express%EB%A1%9C-REST-API%EB%A5%BC-%EA%B0%9C%EB%B0%9C%ED%95%B4%EB%B3%B4%EC%9E%90)