카테고리 없음

RESTful API

wikys 2025. 12. 21. 10:35

😎 한 줄 요약(잘난 척용)

“RESTful API는 서버와 앱이 대화하는 가장 표준적인 약속이다.”

RESTful API란 무엇인가?

서버와 클라이언트가 소통하는 ‘깔끔한 규칙’

 
 

1. RESTful API를 한 문장으로 설명하면

RESTful API는 서버와 클라이언트가 데이터를 주고받기 위한 ‘규칙 있는 방식’이다.

여기서 중요한 건 기술이 아니라 약속이다.
👉 “어떤 요청을 하면, 어떤 형식으로 응답할지”를 미리 정해둔 규칙이다.

2. API부터 먼저 이해해보자 (아주 쉽게)

API란?

API는 요청하면 결과를 돌려주는 창구다.

예를 들면

  • 날씨 앱 → “오늘 서울 날씨 알려줘”
  • 서버 → “맑음, 25도”

👉 이 요청과 응답의 통로가 바로 API다.

3. REST는 무슨 뜻일까?

REST는 Representational State Transfer의 약자다.

하지만 이 뜻을 외울 필요는 없다.
핵심은 이것이다.

“URL은 자원을 나타내고,
행동은 HTTP 메서드로 표현한다.”

4. RESTful API의 핵심 규칙 (중요)

1️⃣ URL은 ‘자원’을 표현한다

URL에는 동작이 아니라 대상이 들어간다.

❌ 나쁜 예

/getUser  
/deletePost

✅ 좋은 예

/users  
/posts

 

2️⃣ 행동은 HTTP 메서드로 구분한다

메서드 의미 예시
GET 조회 유저 목록 가져오기
POST 생성 새 유저 만들기
PUT / PATCH 수정 유저 정보 수정
DELETE 삭제 유저 삭제

👉 URL은 같고, 메서드만 다르다

3️⃣ 응답은 보통 JSON

RESTful API는 보통 JSON 형식으로 응답한다.

{
  "id": 1,
  "name": "홍길동"
}

👉 사람이 봐도, 프로그램이 봐도 이해하기 쉽다.

5. RESTful API는 왜 이렇게 많이 쓰일까?

👍 이유 1: 규칙이 단순하다

  • URL + 메서드
  • 요청 → 응답

👉 배우기 쉽고 협업하기 좋다.

👍 이유 2: 어떤 언어에서도 사용 가능

  • 서버: Node.js, Python, Java, Go
  • 클라이언트: 웹, 앱, IoT

👉 기술이 달라도 같은 규칙으로 소통 가능하다.

👍 이유 3: 프론트엔드와 잘 맞는다

React, Vue 같은 프론트엔드는 👉 RESTful API를 전제로 설계된다.

6. RESTful API는 어디에 쓰일까?

🌐 웹 서비스

  • 로그인
  • 게시글 조회
  • 댓글 작성

📱 모바일 앱

  • 앱 ↔ 서버 통신
  • 데이터 동기화

🤖 외부 서비스 연동

  • 결제 API
  • 지도 API
  • AI 서비스 API

7. RESTful API는 만능일까?

아니다. 한계도 있다.

  • 실시간 통신에는 한계
  • 복잡한 요청에는 불편

그래서 상황에 따라

  • WebSocket
  • GraphQL

같은 방식도 함께 사용된다.

8. 초보자가 기억하면 딱 좋은 정리

  • RESTful API = 서버와 대화하는 규칙
  • URL은 대상, 메서드는 행동
  • JSON으로 데이터 주고받기

이 정도만 이해해도 충분하다.

9. 마무리

RESTful API는 웹과 앱 시대의 공용 언어다. 노드JS, 익스프레스, 모바일 앱, AI 서비스까지👉 거의 모든 현대 서비스의 중심에 있다. 그래서 개발을 몰라도 “RESTful API가 뭔지” 정도는 알고 있으면 요즘 기술 이야기가 훨씬 잘 들린다.

 

참고 자료 (한국어)

✅ 공식·기초 문서

 

HTTP | MDN

가이드와 튜토리얼을 통해 HTTP를 사용하는 방법을 배워보세요. HTTP 개요 클라이언트-서버 프로토콜의 기본 기능들입니다. HTTP로 할 수 있는 것과 의도된 용도를 알아보세요. HTTP 캐시 캐싱은 빠

developer.mozilla.org

 

✅ 입문·정리 글

참고 유튜브 영상 (한국어)

🔹 개념 이해용

 

🔹 개발 흐름 이해

 

- YouTube

 

www.youtube.com

 

반응형
저작자표시 비영리 동일조건 (새창열림)

'카테고리 없음'의 다른글

  • 현재글RESTful API
댓글

티스토리툴바