스키마 검증
스키마 검증은 API 요청, JSON 설정, AI가 생성한 구조화 출력이 약속한 필드·타입·필수값을 지키는지 코드로 확인하는 절차이다. VIBE 코딩에서는 AI가 그럴듯한 JSON을 만들었더라도 실제 런타임이 기대하는 모양과 다르면 저장 실패, 빈 화면, 잘못된 권한 처리로 이어질 수 있다. 그래서 데이터가 DB나 서버 로직에 들어가기 전에 스키마로 확인하고, 실패 메시지를 사용자와 운영자가 이해할 수 있게 남기는 것이 중요하다.
영어 표기
Schema Validation
예시
AI에게 새 Q&A 업로드 API를 만들게 했다면 body에 title, content, topic이 문자열로 들어오는지 스키마 검증을 먼저 통과시킨다. 잘못된 입력은 저장하지 않고 400 응답과 필드별 오류를 남긴 뒤, 정상 입력·누락 입력·타입 오류 테스트 케이스로 회귀를 막는다.
참고
도구 이름보다 데이터 계약을 먼저 정하고, AI 출력·사용자 입력·DB 저장 전 단계에 같은 계약을 적용하는 운영 습관으로 이해하면 쉽다.
카테고리
backend-api
난이도
basic
태그
스키마검증 · JSON
함께 읽기
연관 용어
보안·인증
교차 출처 리소스 공유
영어 표기 CORS (Cross-Origin Resource Sharing)
브라우저가 한 출처의 웹 페이지에서 다른 출처의 API를 호출할 때 적용하는 보안 규칙이다. 프론트엔드와 백엔드 도메인이 다르면 서버가 어떤 출처를 허용하는지 응답 헤더로 알려줘야 한다. 바이브 코딩 초보자가 '브라우저에서는 막히는데 터미널 curl은 된다'는 상황을 만날 때 CORS가 원인인 경우가 많다.
프론트엔드·UI
Next.js 라우트 핸들러
영어 표기 Next.js Route Handler
Next.js App Router에서 app/api/.../route.ts 파일로 만드는 서버 측 API 엔드포인트이다. GET, POST 같은 HTTP 메서드별 함수를 export하여 브라우저 요청을 받고, 데이터베이스 조회나 외부 API 호출 뒤 JSON 응답을 반환한다. 바이브 코딩에서 AI가 프론트엔드 화면만 만들고 저장·조회 API를 빠뜨리거나, 반대로 클라이언트 코드에 비밀 값을 넣는 실수를 할 수 있으므로 라우트 핸들러는 '브라우저에 노출하면 안 되는 서버 작업을 담는 안전한 경계'로 이해해야 한다.
백엔드·인프라
API
영어 표기 API (Application Programming Interface)
소프트웨어 애플리케이션 간 상호작용 방식을 정의하는 프로토콜과 규약의 집합으로, AI 코딩 도구 통합과 현대 소프트웨어 아키텍처의 핵심이다. 비유하면, 레스토랑의 메뉴가 손님(클라이언트)과 주방(서버) 사이의 '인터페이스'인 것처럼, API는 소프트웨어 간의 '메뉴'이다. 바이브 코딩에서 API는 두 가지 맥락으로 사용된다: 첫째, AI 모델 API — Claude API, OpenAI API 등 AI 모델을 호출하는 인터페이스로, 모든 AI 코딩 도구의 내부에서 이 API를 통해 모델과 통신한다. 둘째, 앱 API — AI가 생성하는 백엔드 코드의 핵심으로, REST API, GraphQL API 등의 형태로 프론트엔드와 백엔드를 연결한다. AI에게 '사용자 CRUD API를 REST로 만들어줘'라고 하면 Express.js, FastAPI, Next.js API Routes 등을 사용한 엔드포인트 세트를 생성한다. MCP도 본질적으로 'AI 에이전트가 외부 도구를 호출하는 API의 표준화'이다.