VIBECODING 365 / DICTIONARY
API 계약
API Contract
DEFINITION
정의
API 계약은 프론트엔드와 백엔드가 어떤 주소, 메서드, 요청 필드, 응답 형태, 오류 코드를 약속하는지 적은 실행 기준이다. VIBE 코딩에서는 AI가 화면과 서버 코드를 따로 만들며 필드명이 어긋나기 쉬우므로, 계약을 먼저 고정하면 구현·테스트·리뷰가 같은 기준을 보게 된다. 계약은 문서이면서 동시에 테스트의 체크리스트 역할을 하므로 작은 기능에서도 변경 범위를 안전하게 줄여 준다.
왜 중요한가
작은 프로젝트에서는 문서 한 장이나 테스트 파일만으로도 충분하다. 중요한 점은 AI 작업 지시서, 구현 코드, 검증 명령이 모두 같은 요청·응답 약속을 참조하도록 만드는 것이다.
관련 용어 연결
함께 보면 좋은 용어: endpoint, request, response, rest-api, acceptance-criteria, integration-test, schema. AI 작업 지시서에는 이 연결을 기준으로 화면, API, 테스트의 책임을 나누어 적는다.
ENGLISH
API Contract
EXAMPLE
AI에게 질문 저장 API를 만들게 하기 전 POST 경로, title/body/topic 필드, 성공 응답, 400 오류 형태, 인증 실패 처리, 중복 제출 규칙을 표로 정하고 통합 테스트에서 요청과 응답이 계약과 맞는지 검증한다.
REFERENCE
swagger.io/specification/관련
이어서 볼 문서
RELATED TERMS
연관 용어
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의 표준화'이다.
백엔드·인프라 수파베이스Supabase
Google의 Firebase에 대한 오픈소스 대안으로, PostgreSQL 기반의 백엔드 서비스(인증, 실시간 데이터베이스, 파일 스토리지, Edge Functions, 벡터 검색)를 올인원으로 제공한다. 바이브 코딩으로 만드는 앱에서 가장 인기 있는 백엔드 선택지 중 하나이며, 특히 Lovable(러버블)과의 깊은 통합으로 유명하다. Supabase의 가장 큰 매력은 '바이브 코딩과의 궁합'이 뛰어나다는 점이다: SQL 기반이므로 AI가 스키마 정의와 쿼리 생성을 정확히 수행할 수 있고, Row Level Security(행 수준 보안)로 데이터 접근 제어를 선언적으로 정의할 수 있으며, 자동 생성되는 REST API와 실시간 구독으로 별도의 API 서버 코드가 필요 없다. 오픈소스이므로 자체 호스팅도 가능하고, 무료 티어가 넉넉하여 프로토타이핑에 비용 부담이 없다. AI에게 'Supabase로 백엔드 만들어줘'라고 하면 DB 스키마, RLS 정책, 인증 설정, 실시간 구독 코드까지 한 번에 생성된다.
백엔드·인프라 서버리스Serverless
서버 인프라의 관리(프로비저닝, 스케일링, 패치, 모니터링)를 클라우드 제공자에게 완전히 위임하고, 개발자는 함수 단위의 비즈니스 로직만 작성하는 클라우드 실행 모델이다. '서버가 없다'는 의미가 아니라 '서버를 신경 쓸 필요가 없다'는 뜻이며, 사용한 만큼만 비용을 지불하는(pay-per-execution) 과금 방식이 특징이다. 바이브 코딩과의 궁합이 뛰어난 이유: AI가 백엔드 코드를 생성할 때 서버 설정, 스케일링 로직, 인프라 코드까지 생성할 필요 없이 순수한 비즈니스 로직만 작성하면 되므로, 프롬프트의 복잡도가 크게 줄어든다. Vercel Serverless Functions, AWS Lambda, Google Cloud Functions, Cloudflare Workers 등이 대표적이며, v0나 Bolt.new에서 만든 앱을 원클릭 배포할 때 내부적으로 서버리스 인프라가 사용된다. 다만, cold start(첫 실행 시 지연), 실행 시간 제한, 상태 관리의 어려움 등의 한계가 있으며, AI가 이러한 제약을 고려하지 않는 코드를 생성하는 경우도 있다.