REST API / RESTful 이란?

1. REST (Representational State Transfer)

: 자원을 이름으로 구분하여, 해당 자원의 상태를 주고받는 모든 것

 

'HTML URI'를 통해 자원(Resource)을 명시하고,

'HTML Method(POST, GET, PUT, DELETE, PATCH등)'를 통해 해당 자원(URI)에 대한 'CRUD Operation'을 적용

* CRUD Operation 이란?
- Create : 데이터 생성(POST)
- Read : 데이터 조회(GET)
- Update : 데이터 수정(PUT, PATCH)
- Delete : 데이터 삭제(DELETE)

 

* 자원을 이름으로 구분? = 자원의 표현

- 자원(문서, 사진, 그림, 데이터 등 소프트웨어가 관리하는 모든 것)을 HTTP URI를 통해 명시

ex) DB의 영화 정보가 자원일 때, /movies를 자원의 표현으로 정함

* 자원의 상태를 주고 받음(요청 > 응답)

클라이언트가 자원의 상태(정보)에 대한 조작을 요청하면 서버는 이에 적절한 응답을 보낸다.

=> 전달 방식으로는 JSON 또는 XML를 통해 데이터를 주고 받는것이 일반적

즉, REST는 HTTP URI를 통해 클라이언트와 서버 사이의 통신하는 방식 중 하나로,
HTTP Method를 통해 자원을 처리(CRUD)하도록 설계된 아키텍쳐!

 

 

2. API(Application Programming Interface)

: 웹 API는 클라이언트와 웹 리소스 사이의 네트워크 통신을 위한 게이트웨이. 다른 소프트웨어 시스템과 통신하기 위해 따라야하는 규칙.

 

 

 

3. REST API : REST기반으로 서비스 API를 구현한 것

최근 OpenAPI(누구나 사용할 수 있도록 공개된 API: ChatGPT API 연동, 금융결제원, 다음 우편번호 API 연동 등)등을 제공하는 업체 대부분 REST API를 제공한다. API는 항상 URI 메뉴얼을 제공해야한다. URI를 모르면 클라이언트는 사용할 수 없다.

* REST API 설계 규칙
1) 명사, 소문자 => 동사x
2) 명사는 복수형
3) URI 마지막은 / 포함x
4) URI는 언더바x 하이픈 사용 -
5) 파일의 확장자를 표시x

 

 

 

4. RESTful : REST 원리를 따르는 시스템

'REST API'를 제공하는 웹 서비스를 'RESTful 하다'라고 할 수 있다.

 

* RESTful의 목적 : 이해하기 쉽고 사용하기 쉬운 REST API를 만드는 것

* RESTful하지 못하는 경우 : URI 규칙을 지키지 않은 API는 REST API의 설계 규칙을 올바르게 지키지 않은 시스템은 REST API를 사용했지만, RESTful하지 못한 시스템이다라고 함.

 

 

---

✅ REST API와 API의 차이점

1. API (Application Programming Interface)
   • 애플리케이션 간의 데이터를 주고받을 수 있도록 제공하는 인터페이스.
   • REST, SOAP, GraphQL 등 다양한 방식으로 구현될 수 있음.
2. REST API (Representational State Transfer API)
   • API의 한 유형으로, REST 원칙을 따르는 웹 API를 의미함.
   • HTTP 프로토콜을 기반으로 자원(Resource) 을 CRUD 방식으로 처리함.
   • RESTful API라고도 불리며, 보통 JSON 또는 XML 형식으로 데이터를 주고받음.

✅ 주요 차이점

구분	API	REST API
개념	소프트웨어 간의 통신 인터페이스	REST 원칙을 따르는 웹 API
방식	다양한 프로토콜과 형식 사용 가능	HTTP 기반, URL을 통한 자원 식별
데이터 형식	XML, JSON, 텍스트 등 다양함	주로 JSON 사용
구조	특정한 규칙 없이 자유롭게 설계 가능	RESTful 원칙(자원 중심, HTTP 메서드 활용) 준수

 

즉, 모든 REST API는 API이지만, 모든 API가 REST API는 아니다.