명사형 URI
/createUser보다 /users처럼 리소스를 드러낸다.
URI는 대상을, 메서드는 작업을, 상태 코드는 결과를 맡는다
RESTful API 설계에서는 세 역할을 섞지 않는다. 리소스 이름은 URI에 두고, 행위는 HTTP 메서드로 표현하며, 성공과 실패는 상태 코드로 구분한다.
| 요청 | 의미 | 응답 기준 |
|---|---|---|
GET /users |
사용자 목록 조회 | 200과 배열 응답 |
POST /users |
사용자 생성 | 201과 생성된 리소스 |
PATCH /users/:id |
일부 필드 수정 | 200 또는 204 |
DELETE /users/:id |
사용자 삭제 | 204 또는 삭제 결과 |
일관된 복수형
컬렉션과 단일 리소스 규칙을 같은 방식으로 유지한다.
오류 응답
검증 실패와 없는 리소스를 다른 상태 코드로 구분한다.