피드로 돌아가기
Dev.toBackend
원문 읽기
RPC 기반 단일 엔드포인트에서 RESTful 아키텍처로의 단계적 진화
From Chaos to REST: How I Evolved My First AWS Lambda API
AI 요약
Context
AWS Lambda와 API Gateway 기반의 초기 시스템이 POST 메서드와 내부 필드(tarefa)에 의존한 RPC 스타일의 Tunneling 구조로 설계됨. 이로 인해 HTTP Semantics 무시, 높은 결합도, 일관성 없는 응답 포맷 및 200 OK 남발로 인한 에러 핸들링 부재라는 한계 발생.
Technical Solution
- Action 중심 사고에서 Resource 중심 사고로 전환하여 URI 구조를 /logs 기반으로 재설계
- HTTP Method(GET, POST, PUT, DELETE)를 통한 요청 의도 분리를 통해 거대 조건문(if/elif) 제거
- try/except 블록 도입 및 표준 응답 객체(success, message, data) 정의를 통한 응답 일관성 확보
- 상태 코드(201, 400, 404, 500)를 명시적으로 반환하여 클라이언트-서버 간 인터페이스 표준화
- Route별 책임 분리를 통한 기능적 결합도 해소 및 코드 가독성 향상
실천 포인트
1. 단일 엔드포인트에서 내부 필드로 요청을 분기하는 Tunneling 구조인지 확인
2. HTTP Method가 단순 전달 수단이 아닌 리소스 제어의 의미를 가지는지 검토
3. 모든 응답이 공통 스키마를 따르며 적절한 HTTP Status Code를 반환하는지 체크
4. 비즈니스 로직 진입 전 전역 Exception Handler를 통해 500 에러의 유실 방지