REST API

URL로 자원을 가리키고, HTTP 메서드로 행위를 말한다 — 프론트와 백을 잇는 표준 언어

이 세션에서
배우는 것

왜 REST를
표준처럼 쓸까?

서비스마다 요청 방식이 제각각이라면, 새 프로젝트마다 처음부터 배워야 한다.
REST는 "URL은 자원, 메서드는 행위" 라는 단순한 규칙으로 이 혼란을 정리한다.

한 번 배우면 어느 회사 API든 같은 감각으로 읽을 수 있다.

HTTP 메서드 — CRUD의 네 동사

같은 URL이라도 어떤 메서드로 호출하느냐에 따라 의미가 완전히 달라진다.

REST 원칙 —
더 깊게 이해하기

REST는 6가지 제약 조건을 가진 아키텍처 스타일이다. 핵심만 쉽게 이해하자.

엔드포인트 실전 예시

자원(users)을 두고 메서드와 경로를 조합해 네 가지 동작을 표현한다.

GET    /api/users         → 사용자 목록 조회
GET    /api/users/1       → id=1 사용자 단건 조회
POST   /api/users         → 새 사용자 생성
PUT    /api/users/1       → id=1 사용자 정보 수정
DELETE /api/users/1       → id=1 사용자 삭제

핵심: URL은 명사(자원), 메서드는 동사(행위).

날씨 앱 —
실제로는 어떻게?

날씨 앱을 열 때 기상청 API를 호출하는 과정을 따라가보자.

핵심: URL에 위치 정보를 쿼리로 담아 GET 요청 → 서버는 JSON으로 응답. API 키로 사용자를 인증한다.

데이터의 공용어 — JSON

서버와 클라이언트가 주고받는 데이터 형식. 사람과 기계 모두 읽기 쉽다.

{
  "id": 1,
  "name": "김철수",
  "age": 30,
  "roles": ["admin", "user"]
}

Postman 같은 도구로 코드 없이도 요청을 보내고 응답을 확인할 수 있다.

실생활에서
이렇게 쓰여요

우리가 매일 사용하는 앱과 서비스 속에 이 개념이 녹아 있다.

💡 이 개념이 없다면 매 서비스마다 로그인·지도·결제를 처음부터 직접 개발해야 했을 것이다.

자주 하는
오해 바로잡기

이렇게 생각하기 쉽지만, 실제로는 조금 다릅니다.

REST API는 식당 메뉴판이다

메뉴에 따라 주문 방법이 정해져 있듯이, 엔드포인트마다 요청 규칙이 정해져 있다.

이걸 알면
AI와 이렇게 대화해요

이 개념을 이해하면 Claude나 ChatGPT를 훨씬 잘 활용할 수 있다.

이렇게
이해하셨나요?

💪 REST를 이해하면 모르는 API 문서도 URL과 메서드만 보면 바로 파악할 수 있어요!

핵심 정리

다음 세션
Session 29 · 관계형 데이터베이스 (SQL)

JavaScript로 서버 코드를 짜는 세상을 연 주인공.
V8 엔진, 이벤트 루프, 그리고 Express로 API 서버 만들기.

💡 기억할 것: REST는 URL = 명사, 메서드 = 동사라는 문법이다.