REST 계약

REST API 리소스 의미

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

설계 요소

01Resource 02Method 03Status 04Body 05Error

리소스

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

메서드

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

상태 코드

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

에러 형식

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