REST? RESTful API??

 

💡 Rest (Representational State Transfer)

자원의 이름 (자원의 표현) 으로 구분해 해당 자원의 상태(정보)를 주고 받는 모든것.

자원의 표현에 의해 상태 전달을 하는 것으로 웹의 장점을 최대한 활용하는 아키텍쳐

 

 

자원의 표현?

 : 해당 SW가 관리하는 것들을 표현하기 위한 이름

 

상태(정보) 전달?

 : 데이터가 요청되어지는 시점에서의 자원의 상태(정보)를 전달 (JSON, XML 통해)

 

✏️ 구체적인 개념

 : HTTP URI를 통해 자원을 명시하고 HTTP Method (GET, POST ..)를 통해 

   해당 자원에 대한 CRUD Operation을 적용함

   

   👀  이때 CRUD -> (Create, Read, Update, Delete, Head)

                                      POST      GET       PUT       DELETE   HEAD

 

구성요소

   - 자원 (Resource) : = URI ( Uniform Resource Identifier ) 통합자원식별자

               모든 자원에는 고유한 ID가 있으며 이 자원은 서버에 존재 ex> /groups/:group_id 

               따라서 client는 URI를 이용해 자원을 지정한 후 해당 자원 상태에 대한 조작을 서버에 요청

   - 행위 (Verb) : HTTP Method (GET, POST, PUT, DELETE 등)

   - 표현 :  client가 자원의 상태에 대한 조작을 요청하면 서버는 적절한 응답을 보냄

       

 

REST API 설계 기본 규칙

 

  1. URI는 정보의 자원을 표현

      - resuorce는 명사, 소문자 선호

 

  2. 자원에 대한 행위는 HTTP Method로 표현

      - URI에는 HTTP Method 들어가면 X

      - URI에 행위에 대한 동사 표현이 들어가면 않됨

 

  3. 슬래시 구분자(/)는 계층 관계를 나타내는데 사용

 

  4. URI 마지막 문자로 슬래시 포함하지 않을것  

     - URI에 포함되는 모든 글자는 리소스의 유일한 식별자로 사용되어야 하므로 혼동주지 않기 위해

 

  5. _을 사용하지 않으며 -는 가독성을 높이는데 씀

 

👩🏻‍💻 예시)

CRUD	HTTP Verbs	Route
resource들의 목록 표시	GET	/resource
resource 하나의 내용 표시	GET	/resource/:id
resource를 하나 생성	POST	/resource
resource를 삭제	DELETE	/resource/:id

 

응답 상태 코드 )

• 1xx : 전송 프로토콜 수준의 정보 교환
• 2xx : 클라어인트 요청이 성공적으로 수행됨
• 3xx : 클라이언트는 요청을 완료하기 위해 추가적인 행동을 취해야 함
• 4xx : 클라이언트의 잘못된 요청
• 5xx : 서버쪽 오류로 인한 상태코드