REST API 설계 체크리스트 — 처음 짤 때 놓치는 것들
DELETE /deleteUser/123 같은 URL을 짠 적 있다면 이 글이 필요하다. URL 명사 규칙, HTTP 메서드 구분, 상태 코드 정확하게 쓰기, 응답 포맷 일관성, 에러 응답 구조, 버저닝까지. 잘못된 예와 올바른 예 코드로 한 번에 정리했다.
DELETE /deleteUser/123 같은 URL을 짠 적 있다면 이 글이 필요하다. URL 명사 규칙, HTTP 메서드 구분, 상태 코드 정확하게 쓰기, 응답 포맷 일관성, 에러 응답 구조, 버저닝까지. 잘못된 예와 올바른 예 코드로 한 번에 정리했다.
모놀리식 vs 마이크로서비스 선택은 기술이 아니라 팀 규모의 문제다. 개발자 10명 이하라면 MSA는 오버 엔지니어링이다. CNCF 조사에서 42%가 되돌아간 이유, 모듈러 모놀리스 옵션, 전환 시점 판단 기준까지 실무 관점에서 명확하게 한 번에 정리한다.
DB 인덱스 슬로우 쿼리 때문에 이틀을 날렸다. 운영 DB 50만 건에서 30초 걸리던 API를 EXPLAIN으로 진단하고 복합 인덱스로 0.02초에 해결한 과정이다. EXPLAIN 결과 읽는 법과 복합 인덱스 컬럼 순서 기준도 함께 정리했다.