VIBECODING 365 / DICTIONARY
스키마 검증
Schema Validation
DEFINITION
정의
스키마 검증은 API 요청, JSON 설정, AI가 생성한 구조화 출력이 약속한 필드·타입·필수값을 지키는지 코드로 확인하는 절차이다. VIBE 코딩에서는 AI가 그럴듯한 JSON을 만들었더라도 실제 런타임이 기대하는 모양과 다르면 저장 실패, 빈 화면, 잘못된 권한 처리로 이어질 수 있다. 그래서 데이터가 DB나 서버 로직에 들어가기 전에 스키마로 확인하고, 실패 메시지를 사용자와 운영자가 이해할 수 있게 남기는 것이 중요하다.
참고
도구 이름보다 데이터 계약을 먼저 정하고, AI 출력·사용자 입력·DB 저장 전 단계에 같은 계약을 적용하는 운영 습관으로 이해하면 쉽다.
ENGLISH
Schema Validation
EXAMPLE
AI에게 새 Q&A 업로드 API를 만들게 했다면 body에 title, content, topic이 문자열로 들어오는지 스키마 검증을 먼저 통과시킨다. 잘못된 입력은 저장하지 않고 400 응답과 필드별 오류를 남긴 뒤, 정상 입력·누락 입력·타입 오류 테스트 케이스로 회귀를 막는다.
NOTES
도구 이름보다 데이터 계약을 먼저 정하고, AI 출력·사용자 입력·DB 저장 전 단계에 같은 계약을 적용하는 운영 습관으로 이해하면 쉽다.
관련
이어서 볼 문서
RELATED TERMS
연관 용어
OpenAI Responses API
OpenAI가 Chat Completions 다음에 내세운 상태형 응답 표면이다. 입력은 input, 출력은 Items이며, previous_response_id로 대화를 잇는다.
security 교차 출처 리소스 공유Cross-Origin Resource Sharing (CORS)
다른 출처 페이지의 스크립트가 이 응답을 읽어도 되는지, 서버가 HTTP 헤더로 브라우저에 알리는 방식이다. 요청이 가는 것과 스크립트가 읽는 것은 다르며, 쿠키를 실을 때는 별표 출처가 허용되지 않는다.
프론트엔드·UI Next.js 라우트 핸들러Next.js Route Handler
Next.js App Router에서 app/api/.../route.ts 파일로 만드는 서버 측 API 엔드포인트이다. GET, POST 같은 HTTP 메서드별 함수를 export하여 브라우저 요청을 받고, 데이터베이스 조회나 외부 API 호출 뒤 JSON 응답을 반환한다. 바이브 코딩에서 AI가 프론트엔드 화면만 만들고 저장·조회 API를 빠뜨리거나, 반대로 클라이언트 코드에 비밀 값을 넣는 실수를 할 수 있으므로 라우트 핸들러는 '브라우저에 노출하면 안 되는 서버 작업을 담는 안전한 경계'로 이해해야 한다.