44. REST API

• REST : HTTP 기반으로 클라이언트가 서버의 리소스에 접근하는 방식을 규정한 아키텍처
• REST API : REST 기반으로 서비스 API 구현
• RESTful : REST의 기본 원칙을 잘 구현해낸 서비스 디자인

44.1. REST API 구성

• 자원 (Resource) : 자원
  • 표현 방법: URI (엔드포인트)
• 행위 (Verb) : 자원에 대한 행위
  • 표현 방법: HTTP 요청 메서드
• 표현 (Representations) : 자원에 대한 행위의 구체적 내용
  • 표현 방법: 페이로드

44.2. REST API 설계 원칙

1. URI는 리소스 표현

• 리소스 이름은 명사 권장 (동사 표현 지양)
• GET /todos/show/1 (x) -> GET /todos/1 (o)

2. HTTP 요청 메서드는 행위에 대한 정의

• HTTP 요청 메서드는 클라이언트가 서버에게 요청의 종류와 목적을 알리는 방법
  • 행위는 요청 메서드를 통해 표현하므로 URI에는 표현하지 않음
  • GET /todos/delete/1 (x) -> DELETE /todos/1 (o)
• 5가지 요청 메서드
  

44.3. JSON Server 실습

• GET : 데이터 취득
• POST : 데이터 생성
• PUT : 리소스 전체 교체
• PATCH : 리소스 일부 수정
• DELETE : 데이터 삭제

[출처] 모던 자바스크립트, Deep Dive