rest api란?

용어를 이해할려면 단어가 무슨뜻인지 이해하면 쉽다

 

Rest

"REpresentational State Transfer" 의 약자로, 자원을 이름(자원의 표현)으로 구분해 해당 자원의 상태(정보)를 주고 받는 모든 것을 의미

 

즉, 자원(resource)의 표현(representation)에 의한 상태 전달을 뜻합니다.

• 자원 : 해당 소프트웨어가 관리하는 모든 것 ( 문서, 그림, 데이터, 해당 소프트웨어 자체 등 )
• 표현 : 그 자원을 표현하기 위한 이름 ( DB의 학생 정보가 자원이면, 'students'를 자원의 표현으로 정함 )
• 상태 전달 : 데이터가 요청되는 시점에 자원의 상태를 전달한다. ( JSON 혹은 XML을 통해 데이터를 주고 받는 것이 일반적 )

출처: https://dev-coco.tistory.com/97 [슬기로운 개발생활:티스토리]

API란?

Application Programming Interface (Application Programming Interface, 응용 프로그램 프로그래밍 인터페이스)

 

Application : 사용자의 특정 목적을 위해 만들어진 프로그램(소프트웨어)

윈도우 운영체제나 iOS처럼 기초 시스템이 아니라, “목적이 있는 프로그램”을 “응용 프로그램”이라고 부름

EX) 카톡, 유튜브 등

인터페이스 (Interface)
서로 다른 두 시스템이 연결되어 소통하는 접점
사람-기계, 프로그램-프로그램 간의 약속된 소통 방식

즉

rest api는 한마디로

자원(데이터)을 주고받기 위한 규격(약속된 방식)이다~

---

✅ REST API란?

🔹 REST = REpresentational State Transfer

자원을 URL로 표현하고, HTTP 방식(GET, POST, PUT, DELETE 등)을 이용해
자원을 주고받는 규칙(아키텍처 스타일)이에요.

🔹 REST API란?

REST 원칙을 따르는 웹 API (데이터를 주고받는 약속된 방식)

---

✅ 핵심 개념

1️⃣ 자원(Resource) → 어떤 "것"

서버가 가진 정보 단위
예: 사용자(user), 게시글(post), 채팅(chat)

2️⃣ 자원을 나타내는 방법 → URL

GET  /users        → 사용자 목록 요청
POST /users        → 사용자 추가 요청
GET  /users/7      → ID가 7인 사용자 정보 요청
PUT  /users/7      → 사용자 정보 수정
DELETE /users/7    → 사용자 삭제

3️⃣ 행동(행위) → HTTP 메서드

메서드	의미
GET	자원 조회 (받기)
POST	자원 생성 (쓰기)
PUT	자원 수정 (덮어쓰기)
DELETE	자원 삭제

---

✅ 예시로 정리하면

동작	REST API	요청 의미
모든 책 목록 보기	GET /books	책 리스트 요청
새 책 추가	POST /books + 책 정보	책 생성
책 3번 정보 보기	GET /books/3	특정 책 정보 요청
책 3번 수정	PUT /books/3 + 수정 내용	책 정보 수정
책 3번 삭제	DELETE /books/3	책 삭제

---

✅ 한 줄 요약

REST API는
웹에서 자원을 다룰 때
어떤 URL로,
어떤 방식(GET/POST 등)으로,
어떤 데이터를 주고받을지를 정한 통신 규약이에요.

 

참고)

https://dev-coco.tistory.com/97

 

REST란? REST API 와 RESTful API의 차이점

 

https://dev-dain.tistory.com/50

봐도봐도 모르겠는 API 개념 설명 (Application Programming Interface)