타입스크립트로 안전한 API 레이어 설계하기

프론트엔드에서 API를 호출할 때 타입만 믿고 가면, 실제 응답 형태가 바뀌었을 때 조용히 깨지는 경우가 많습니다.

이 글은 요청·응답·에러를 타입으로 묶는 API 레이어를 어떻게 나누면 좋은지 정리한 임시 초안입니다.

왜 API 레이어를 분리할까?

• 컴포넌트에서 fetch 로직이 반복되지 않습니다.
• 응답 검증 지점이 한곳으로 모입니다.
• 에러 처리 방식을 통일할 수 있습니다.

다음에 다룰 내용

• Zod로 응답 스키마 검증하기
• React Query와 함께 쓰는 패턴
• 공통 에러 타입 설계

임시 글입니다. 레이아웃 확인용 초안이에요.