NestJS · Frontend Contract

프런트엔드 통합을 위한 오류와 타입 계약

프런트엔드 통합의 품질은 API 호출 성공 예제가 아니라, 타입 문서, 인증 방식, CORS, 오류 형식이 화면 코드와 같은 계약을 바라보는지에 달려 있다.

01

계약 공개

DTO와 status code, 오류 body 예시를 OpenAPI 또는 schema로 제공한다.

02

인증 연결

쿠키 기반인지 bearer token 기반인지에 맞춰 프런트 요청 옵션을 고정한다.

03

오류 매핑

validation 오류, 인증 오류, 권한 오류, 서버 오류를 화면 상태로 분리한다.

04

환경 분리

개발·스테이징·운영 API URL과 CORS 허용 출처를 따로 관리한다.

SDK
타입화된 호출 OpenAPI 생성 클라이언트나 shared schema로 drift 감소
버전 관리 필요
CORS
브라우저 접근 허용 origin과 credential 정책이 맞아야 함
wildcard와 cookie 조합 불가
Error shape
화면 표시 fieldErrors, code, message를 표준화
폼 오류 매핑
Auth
세션 연결 401과 403을 다른 사용자 행동으로 연결
토큰 갱신 루프 점검

문서 · 프리플라이트 · 오류 점검

문서 프런트가 필드명을 추측하지 않는다.
프리플라이트 custom header와 credentials 요청이 OPTIONS에서 허용된다.
오류 폼 오류가 필드별로 화면에 표시된다.
비밀 프런트 번들에 서버 비밀값이 들어가지 않는다.