Node.js API Guide 00 — Prologue: 왜 API 서버부터 시작하는가 | 0xccffff Log

Prologue — 왜 Node.js로 API 서버부터 시작하는가#

처음 코딩을 배우려 하면 보통 이런 지점에서 멈춥니다.

설치부터 막힌다
용어가 너무 많다
검색하면 정보는 많은데, 흐름이 이어지지 않는다
그래서 “시작”을 못 하고 포기한다

이 시리즈는 그걸 줄이려고 만들었습니다.
설명을 길게 하기보다, 먼저 동작하는 결과물을 만들고 그 위에 필요한 개념을 쌓는 방식으로 갑니다.

Note

이 시리즈를 끝까지 따라오면

내 컴퓨터에서 Node.js로 서버를 직접 실행할 수 있고
브라우저/터미널로 API 요청을 보내고 JSON 응답을 확인할 수 있으며
간단한 TODO(메모) API를 만들고, 파일 저장까지 할 수 있습니다.

대상#

코딩이 처음이거나, 해보다가 설치/에러에서 포기한 적이 있는 사람
“서버”, “API”라는 단어가 낯선 사람
설명보다 따라 하면서 배우는 방식이 맞는 사람

막힘없이 따라오면 15분, 중간에 에러가 나더라도 40분 안에는 무조건 해결할 수 있게 구성했습니다.

왜 하필 “API 서버”인가?#

API 서버는 식당의 점원과 비슷합니다. 주문(요청)을 받아 주방의 결과(데이터)를 손님에게 가져다주는 역할입니다.

Node.js로 할 수 있는 건 정말 많습니다. (웹, CLI, 봇, 자동화 등)
그중에서 초보가 시작하기에 가장 부담이 적고, 효과가 큰 게 API 서버라고 봅니다.

결과가 바로 눈에 보입니다

주소를 치면 JSON이 뜹니다. “내가 만든 게 동작한다”를 바로 확인할 수 있습니다.

Node.js의 역할이 명확해집니다

Node.js는 브라우저 밖에서 JavaScript를 실행하는 런타임이고,
서버는 요청(request)을 받아 응답(response)을 돌려주는 프로그램입니다.
API 서버를 한 번 만들어 보면 개념이 말이 아니라 감각으로 잡힙니다.

웹 개발(프론트)을 하기 전에 해두면 더 수월합니다
UI부터 만들면 “버튼은 눌리는데 데이터가 안 온다” 같은 상황에서 자주 막힙니다.
API 서버를 먼저 해두면 웹 개발의 핵심 흐름이 미리 잡힙니다.

요청 → 응답 구조를 이해하게 됨
JSON 데이터 형태를 먼저 설계해볼 수 있음
문제 원인을 좁히기 쉬움(서버 문제인지, 클라이언트 문제인지)

확장 흐름이 자연스럽습니다

메모리 저장 → 파일 저장 → 간단 인증 → 배포
다음 단계로 넘어갈 때 공부가 덜 끊깁니다.

이 시리즈의 약속#

한 길만 안내합니다. 선택지를 최소화합니다.
각 단계에는 정상 확인(기대 결과) 이 있습니다.
추가 설명은
Note

Tip
로 정리합니다.
실수 예방은
Warning

Danger
로 표시합니다.
준비물이 필요한 단계는 로 표시합니다.

목차#

시작하기 전에 한 줄만#

이 시리즈의 목표는 완주입니다.
처음엔 이해가 100% 안 돼도 괜찮습니다. 따라 하면서 감을 먼저 잡는 쪽으로 갑니다.

다음 글: 01. 개발환경 세팅