개요

REST란 REpresentational State Transfer의 약자이다.

아래와 같은 규정을 기반으로 구현된 데이터 통신의 전반적인 개념 자체를 뜻한다.

• HTTP URL를 통해 자원을 명시하고 ⇒ user 데이터 명시 → http://restapi.com/**user**
• HTTP **Method(POST, GET, PUT, DELETE,…)를 통해, 해당 자원에 대한 행동을 명시하는 것. ⇒ DELETE http://restapi.com/**user + BadyData{user_id : ‘abc123’}
• 필요 정보는 bady 혹은

RESTful은 일반적으로 REST라는 '아키텍처를 구현하는' 웹 서비스를 나타내는 용어이다.

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

REST 자체는 자원을 이름(자원의 표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 "모든 것"을 의미한다.

REST API 설계

URL 설정

• 마지막에 / 가 오면 안됨

  <aside> 🚫 http://api.test.com/users/

  </aside>

• ‘_’ 언더바 대신 ‘-’ 대시를 사용

  <aside> 🚫 http://api.test.com/users/post_data

  </aside>

• 소문자만 사용

  <aside> 🚫 http://api.test.com/users/postData

  </aside>

• 행위는 URL에 포함하지 않음

  행위는 HTTP 메소드(POST, GET, PUT, DELETE, PATCH 등)을 통해 구분한다.

  <aside> 💡 DELETE http://api.test.com/users/post_data

  </aside>

  • POST : 데이터 생성
  • GET : 데이터 조회
  • PUT : 데이터 전체 수정
  • PATCH : 데이터 일부 수정
  • DELETE : 데이터 삭제

• 컨트롤 자원을 의미하는 URL은 예외적으로 동사를 허용 (행위)