리소스 모델링
동사형 작업보다 클라이언트가 다룰 대상을 먼저 정의한다.
메서드 매핑
조회, 생성, 수정, 삭제의 의미를 HTTP method에 맞춘다.
오류 설계
validation, not found, conflict, forbidden을 다른 코드와 본문으로 표현한다.
확장
pagination, filtering, versioning을 초기에 계약에 포함한다.
/users
컬렉션
목록 조회와 생성 대상
필터는 query
/users/{id}
단일 리소스
조회, 수정, 삭제 대상
없는 id는 404
201
생성 성공
새 리소스와 Location header를 줄 수 있음
POST 성공
409
상태 충돌
중복 이메일, 버전 충돌처럼 현재 상태와 충돌
400과 구분