REST foundation

REST API는 리소스, 메서드, 상태 코드, DTO 계약으로 읽는다

좋은 REST 설계는 컨트롤러 이름보다 클라이언트가 예측할 수 있는 URI와 응답 규칙에서 드러난다. 네 요소가 같은 리소스 규칙을 설명해야 한다.

R

Resource

명사형 URI로 API가 다루는 대상을 표현한다.

M

Method

GET, POST, PATCH, DELETE로 행위를 구분한다.

S

Status

200, 201, 400, 404처럼 결과를 코드로 말한다.

D

DTO

요청과 응답의 모양을 계약으로 고정한다.

핵심: URI는 대상, HTTP 메서드는 작업, 상태 코드는 결과, DTO는 데이터 모양을 맡는다.