REST API 리소스 의미

API 설계에서는 URL을 동사 나열로 만들기보다 리소스와 method, 상태 코드, 에러 형식을 일관되게 맞추는 것이 중요합니다.

1

리소스

users, posts처럼 다루는 대상을 명사로 표현합니다.

2

메서드

GET, POST, PUT/PATCH, DELETE가 조회와 변경 의미를 나눕니다.

3

상태 코드

201, 400, 401, 404, 500처럼 결과를 기계가 읽을 수 있게 합니다.

4

에러 형식

클라이언트가 사용자 메시지와 재시도 여부를 판단하도록 일관된 구조를 둡니다.

핵심REST API 리소스 의미은 각 요소의 관계와 선택 조건을 함께 읽어야 한다.