[RESTful] RESTful 서비스란?

RESTful 서비스란?

---

1. REST

1. REST API

2. RESTful

---

1. REST

REST(Representational State Transfer)는 웹 기반 분산 시스템을 위한 아키텍처 스타일입니다.

HTTP URI(Uniform Resource Identifier)를 통해 자원을 식별하고, HTTP Method(GET, POST, PUT, PATCH, DELETE)를 통해 해당 자원에 대한 CRUD 작업을 수행합니다.

 

- HTTP Method

1. GET

자원 조회

 

2. POST

자원 생성

 

3. PUT

자원 수정(전체)

 

4. PATCH

자원 수정(일부만)

 

5. DELETE

자원 삭제

 

- REST 아키텍처 사용 이유

클라이언트와 서버를 명확하게 구분하여 작업을 수행합니다.

HTTP 메소드 중 GET과 POST만 사용할 경우에도 클라이언트와 서버의 구분은 가능하지만 PUT과 DELETE 등을 활용하면 API가 더 직관적이 고 유지보수가 쉬워집니다.

 

 

- 규칙

/users/{userId}

 

1. 슬래시 구분자는 계층 관계를 나타내는데 사용

2. URI 마지막 문자로 슬래시 포함하지 않음

3. 하이픈은 URI 가독성을 높이는데 사용

4. 밑줄은 URI에 사용하지 않음

5. URI 경로는 소문자 사용

6. 파일 확장자는 URI에 포함하지 않음

 

7. 리소스 간에는 연관 관계가 있는 경우 경로로 표현

8. URI는 명사 사용

 

- 상품 (Products) 관련 API

기능	HTTP 메서드	URI	설명
모든 상품 조회	GET	/products	모든 상품 목록 가져오기
특정 상품 조회	GET	/products/{productId}	특정 상품 정보 조회
상품 생성	POST	/products	새 상품 추가
상품 수정	PUT	/products/{productId}	특정 상품 수정
상품 삭제	DELETE	/products/{productId}	특정 상품 삭제

 

- 주문 (Orders) 관련 API

기능	HTTP 메서드	URI	설명
모든 주문 조회	GET	/orders	모든 주문 목록 가져오기
특정 주문 조회	GET	/orders/{orderId}	특정 주문 정보 조회
주문 생성	POST	/orders	새 주문 생성
주문 수정	PUT	/orders/{orderId}	주문 정보 수정
주문 취소	DELETE	/orders/{orderId}	특정 주문 취소

 

2.  REST API

REST API는 REST 아키텍처 스타일을 기반으로 하는 API입니다.

REST 원칙을 기반으로 HTTP를 사용하여 자원에 접근하는 API지만, 모든 REST 규칙을 엄격히 따르지 않을 수 있습니다.

 

3.  RESTful

REST 아키텍처의 규칙을 정확하게 따르는 웹 서비스를 RESTful 웹 서비스라고 합니다.

---

참고 사이트

REST API URL 규칙

 

[간단정리] REST, REST API, RESTful 특징

 

문제가 있으면 댓글 남겨주세요 !

피드백은 언제나 환영입니다 <3