django - RESTful API

RESTful API

REST(REpresentational State Transfer)란 웹에 존재하는 모든 자원(이미지, 동영상, 데이터 등)에 고유한 URI를 부여하여 자원에 대한 주소를 지정하는 방법론 또는 규칙을 말한다. RESTful API는 REST 특징을 지키면서 API를 제공한다는 의미다.

RESTful API는 요청을 보내는 주소만으로도 무슨 요청인지 누구나 대략 알 수 있다. REST 규칙은 아래와 같다.

• 명사만 사용
  

• /(slash)는 계층 관계를 나타낼 때만 사용. 그 외의 경우는 쿼리스트링을 사용
  

  • product/category/3 프로덕트 하위 카테고리 중 3번째. 특정 테이블의 특정 데이터를 찾아가는 주소
    
  • product?category=3 카테고리 id가 3인 것. 원하는 정보를 보기 위한 필터링 개념
    
  • product?category=3&name=men 카테고리 id가 3인 것 중 ‘men’이 들어간 것 전부 호출
    
• _(underscore)는 사용하지 않음
  
• 대문자보다는 소문자 사용
  

참고) 이렇게 만든 API 주소는 도메인과는 다르다. 도메인은 클라이언트가 사용하는 것이고 API 주소는 프론트가 백에 요청할 때 사용한다.

요청을 보낼 때 사용하는 메소드

여러 메소드가 있지만 RESTful API에서는 주로 4가지 메소드를 사용한다.

• POST 쓰기(Create)
  
• GET 읽기(Read)
  
• PUT 수정(Update)
  
• DELETE 삭제(Delete)
  

참고) PATCH는 부분 수정할 때 사용하는 메소드지만 보통 PUT 메소드로 통합해서 사용한다. 바뀌지 않는 value는 똑같은 value로 덮어씌워지고 변경사항이 있는 것만 반영된다.