메서드 규칙

HTTP 메서드는 안전성과 멱등성 기준으로 설계한다

GET, POST, PUT, PATCH, DELETE는 서버 상태 변경 여부와 같은 요청 재시도 결과로 구분합니다.

GET

리소스 조회이며 서버 상태를 바꾸지 않는 안전한 메서드로 설계합니다.

POST

생성, 명령, 제출처럼 처리 결과가 매번 달라질 수 있는 작업에 씁니다.

PUT

대상 리소스를 전체 교체하는 의미라 같은 요청 반복 결과가 같아야 합니다.

DELETE

삭제 요청은 멱등적으로 설계하되 권한과 복구 정책을 명확히 둡니다.

재시도 기준

네트워크 timeout 뒤 자동 재시도해도 안전한지 메서드별로 판단합니다.

캐시 기준

GET은 캐시와 프리페치 대상이 될 수 있어 부작용이 없어야 합니다.

메서드 의미 검수

API 엔드포인트를 메서드 의미와 상태 변화로 설명합니다.