API 계약
API 계약은 프론트엔드와 백엔드가 어떤 주소, 메서드, 요청 필드, 응답 형태, 오류 코드를 약속하는지 적은 실행 기준이다. VIBE 코딩에서는 AI가 화면과 서버 코드를 따로 만들며 필드명이 어긋나기 쉬우므로, 계약을 먼저 고정하면 구현·테스트·리뷰가 같은 기준을 보게 된다. 계약은 문서이면서 동시에 테스트의 체크리스트 역할을 하므로 작은 기능에서도 변경 범위를 안전하게 줄여 준다.
영어 표기
API Contract
예시
AI에게 질문 저장 API를 만들게 하기 전 POST 경로, title/body/topic 필드, 성공 응답, 400 오류 형태, 인증 실패 처리, 중복 제출 규칙을 표로 정하고 통합 테스트에서 요청과 응답이 계약과 맞는지 검증한다.
공식·관련 링크
swagger.io/specification/카테고리
백엔드·인프라
난이도
basic
태그
backend · api
함께 읽기
연관 용어
백엔드·인프라
HTTP
영어 표기 HTTP (Hypertext Transfer Protocol)
브라우저와 서버가 요청과 응답을 주고받는 웹의 기본 통신 규칙이다. 사용자가 주소를 열면 브라우저가 HTTP 요청을 보내고, 서버는 HTML, JSON, 이미지 같은 응답을 돌려준다. 상태 코드 200, 404, 500과 GET, POST 같은 메서드는 웹 앱 디버깅의 가장 기본 언어이므로 바이브 코딩 초보자도 반드시 익혀야 한다.
백엔드·인프라
URL
영어 표기 URL (Uniform Resource Locator)
웹에서 특정 페이지나 리소스의 위치를 나타내는 주소이다. 도메인, 경로, 쿼리 문자열 같은 부분으로 구성되며, 같은 앱 안에서도 /qna, /hermes, /vibe-dictionary처럼 경로에 따라 다른 화면이 열린다. AI에게 라우팅이나 링크 수정을 요청할 때 URL 구조를 이해하면 깨진 링크와 잘못된 리다이렉트를 더 빨리 찾을 수 있다.
백엔드·인프라
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의 표준화'이다.