974. RESTful API — Brain Science

핵심 인사이트 (3줄 요약)

본질: RESTful API는 빈출 주제와 용어에서 핵심 동작과 제약을 이해하게 해 주는 개념이다.

가치: RESTful API를 이해하면 구분 명확성과 설명력 사이의 균형을 더 정확히 볼 수 있다.

판단 포인트: 설계 시에는 개념 자체보다 적용 조건, 운영 복잡도, 인접 기술과의 경계를 함께 판단해야 한다.

Ⅰ. 개요 및 필요성

웹(Web)의 창시자 팀 버너스리가 만든 HTTP 프로토콜의 장점을 극대화하기 위해 탄생한 아키텍처 스타일(설계 철학)입니다.
API (Application Programming Interface): 내 앱이 카카오톡 서버에게 "친구 목록 좀 줘!"라고 요청할 때 쓰는 '명령어 소통 창구'입니다.
이 API를 **"REST의 철학(규칙)을 완벽하게 지켜서(RESTful) 아름답게 만들자!"**는 것이 핵심입니다.

[HTTP/2 멀티플렉싱]
    │
    ▼
[RESTful API]
    │
    └──▶ [웹소켓]

📢 섹션 요약 비유: RESTful API는 왜 필요한지 보여주는 교통 규칙 표지판과 같다. 문제가 생긴 배경을 알면 이후 선택도 쉬워진다.

Ⅱ. 아키텍처 및 핵심 원리

1. 자원 (Resource)은 명사(URI)로만 표현하라! 🌟

조작하려는 대상(데이터)은 인터넷 주소(URI)로 정확하고 심플하게 찍어줘야 합니다. 동사(행동)가 주소에 들어가면 쓰레기 취급받습니다.
❌ 나쁜 예: http://naver.com/deleteUser?id=5 (URL에 delete라는 동사가 들어감)
✅ 좋은 예 (RESTful): http://naver.com/users/5 (오직 '5번 유저'라는 자원만 명사로 예쁘게 지정함)

2. 행위 (Verb)는 오직 HTTP Method로만 하라! (CRUD 맵핑) 🌟

자원(URI)을 찾았으면, 그 자원을 지지고 볶는 행위는 오직 4대 HTTP 메서드로만 표현해야 합니다.

GET (조회, Read): "5번 유저 정보 가져와!" ➜ GET /users/5
POST (생성, Create): "새 유저 만들어!" ➜ POST /users (데이터는 본문에 숨겨서)
PUT / PATCH (수정, Update): "5번 유저 이름 철수로 수정해!" ➜ PUT /users/5
DELETE (삭제, Delete): "5번 유저 탈퇴시켜!" ➜ DELETE /users/5
(똑같은 /users/5 라는 주소 하나만 가지고도, 앞에 어떤 메서드(동사)를 붙이냐에 따라 서버가 완벽하게 다르게 동작하는 미니멀리즘의 극치입니다.)

3. 표현 (Representation) - JSON 대통합

서버가 "5번 유저 정보 여기 있어!"라고 답장을 줄 때 옛날엔 무거운 XML을 썼지만, 요즘 RESTful API는 100% JSON (JavaScript Object Notation) 형식(중괄호 덩어리)으로 던져주는 것이 산업 표준(De facto)이 되었습니다.

[HTTP/2 멀티플렉싱]
    │
    ▼
[RESTful API]
    │
    └──▶ [웹소켓]

📢 섹션 요약 비유: RESTful API의 내부 원리는 기계의 톱니바퀴처럼 맞물려 돌아간다. 한 부분이 어긋나면 전체 효과가 떨어진다.

Ⅲ. 비교 및 연결

REST 아키텍처가 클라우드 시대를 지배한 치명적 이유입니다.

Stateless: 서버는 클라이언트(폰)의 과거 상태(로그인 여부 등)를 절대 기억하지 않습니다.
클라이언트는 매번 요청(GET)을 날릴 때마다 "저 로그인 한 철수인데요, 5번 유저 주세요"라고 토큰(인증표)을 패킷에 포함해서 쏴야 합니다.
클라우드의 축복: 서버가 고객의 기억(상태)을 뇌(RAM)에 저장하지 않으니 서버가 엄청 가벼워집니다. 트래픽이 폭주해서 카카오 서버를 1대에서 10,000대로 늘려도(Scale-Out), எந்த 서버로 요청이 들어가든 100% 완벽하게 처리됩니다.

RESTful API를 볼 때는 앞뒤 개념과의 경계를 함께 봐야 전체 흐름이 선명해진다. HTTP/2 멀티플렉싱이 기반 조건을 만든다면, RESTful API는 그 위에서 핵심 메커니즘을 구현하고, 웹소켓은 이를 더 확장된 적용 단계로 연결한다. 따라서 단일 정의보다 구분 명확성과 설명력에 어떤 차이를 만드는지 비교하는 것이 중요하다.

관점	선행 개념	현재 개념	확장 개념
초점	HTTP/2 멀티플렉싱의 기반 정리	RESTful API의 핵심 동작	웹소켓의 확장 적용
자원 관점	기본 조건 확보	구분 명확성 최적화	규모와 범위 확대
판단 포인트	도입 가능성 확인	현재 메커니즘의 적합성 판단	운영·확장 전략 연결

📢 섹션 요약 비유: RESTful API는 비슷한 기술들 사이의 차선을 구분하는 분기점과 같다. 어디서 갈라지는지 알아야 헷갈리지 않는다.

Ⅳ. 실무 적용 및 기술사 판단

RESTful은 완벽하지만, 화면 하나에 유저 정보, 댓글, 좋아요 개수 등 여러 데이터가 필요할 때 서버에 GET 요청을 3~4번 날려야 하는 단점(Over-fetching)이 있습니다.
이를 박살 내기 위해 페이스북은 "그냥 쿼리문 한 줄로 필요한 데이터만 골라서 한 방에 뽑아오자!"며 **GraphQL(478번 문서)**을 만들었고, 구글은 **gRPC(479번 문서)**를 만들어 REST와 경쟁하고 있습니다.

실무 체크리스트

요구사항과 병목 지점을 먼저 수치화한다.
운영 복잡도와 도입 효과를 함께 검증한다.
인접 기술과의 연계를 배포 전에 점검한다.

📢 섹션 요약 비유: 옛날 API 시스템은 동네 식당의 '주먹구구식 주문'과 같았습니다. 어떤 손님은 "사장님, 김치찌개 하나 취소요!", 어떤 손님은 "메뉴판에서 3번 빼주세요!" 라며 규칙 없이 아무 말이나 던져서 주방장(서버)이 헷갈려 요리를 망쳤습니다. RESTful API는 이 식당에 완벽한 **'전 세계 공통 키오스크 터치 주문 규칙'**을 세운 것입니다. 1. 메뉴(자원)는 무조건 메뉴판 번호(URI 명사)로만 찍습니다. ("3번 찌개"). 2. 주문 행동(행위)은 무조건 4개의 버튼(GET 보기, POST 주문, PUT 변경, DELETE 취소)만 누를 수 있습니다. "3번 찌개"를 고르고 "DELETE" 버튼을 누르면 군말 없이 주문이 취소됩니다. 전 세계 어떤 개발자가 와도 1초 만에 메뉴판(API)을 쓱 보고 직관적으로 코드를 짤 수 있게 만든 가장 아름답고 규격화된 대화법입니다.

Ⅴ. 기대효과 및 결론

RESTful API는 빈출 주제와 용어를 이해할 때 핵심 축을 잡아 주는 개념이다. 올바르게 적용하면 구분 명확성 개선과 구조적 단순화에 기여하지만, 조건을 잘못 잡으면 오히려 복잡도와 운영 부담이 커질 수 있다. 앞으로는 웹소켓, 컨텍스트 기반 용어 해석, 자동화 운영과의 결합을 통해 더 정교하게 발전할 가능성이 크다. 따라서 이 개념은 정의 자체보다 “언제 쓰고 언제 다른 방법으로 넘길 것인가”의 관점으로 기억하는 것이 좋다. 향후에는 컨텍스트 기반 용어 해석 같은 자동화 흐름과 결합되어 더 정교한 형태로 확장될 가능성이 크다.

📢 섹션 요약 비유: RESTful API는 큰 흐름 속에서 기억해야 오래 남는다. 지금의 장점과 다음 확장 방향을 같이 보면 전체 그림이 선명해진다.

📌 관련 개념 맵

개념	연결 포인트
HTTP/2 멀티플렉싱	현재 개념이 등장하기 전에 갖춰야 할 배경이나 인접 선행 개념이다.
정의 (Definition)	용어의 시작점을 분명하게 만든다.
비교 (Comparison)	헷갈리는 개념의 경계를 드러낸다.
웹소켓	현재 개념이 확장되거나 적용 단계로 이어질 때 자주 함께 언급된다.

📈 관련 키워드 및 발전 흐름도

[선행 개념: HTTP/2 멀티플렉싱]
    │
    ▼
[현재 개념: RESTful API]
    │
    ├──▶ [확장 A: 웹소켓]
    └──▶ [확장 B: 컨텍스트 기반 용어 해석]

RESTful API는 HTTP/2 멀티플렉싱에서 출발해 현재 메커니즘을 정교화하고, 이후 웹소켓와 컨텍스트 기반 용어 해석 같은 확장 흐름으로 이어진다고 보면 기억이 오래간다.

👶 어린이를 위한 3줄 비유 설명

비슷한 이름의 장난감을 헷갈리지 않게 표를 붙이는 것과 같아요.
이 개념은 무엇이 어떻게 다른지 쉽게 구별하게 도와줘요.
그래서 시험에서도 실무에서도 말을 더 정확하게 쓸 수 있어요.