VIBECODING 365 / DICTIONARY
Idempotency
DEFINITION
멱등성은 같은 요청을 한 번 보내든 여러 번 보내든 최종 결과가 같게 유지되는 성질이다. 결제, 주문 생성, 이메일 발송, 웹훅 처리처럼 네트워크 재시도나 사용자의 중복 클릭이 생길 수 있는 기능에서 특히 중요하다. 바이브 코딩에서는 AI가 단순히 POST 로직만 만들지 않도록 요청 고유 키, 중복 처리 정책, 재시도 응답, 운영 로그 확인을 함께 명시해야 중복 결제나 중복 데이터 생성을 막을 수 있다.
ENGLISH
Idempotency
EXAMPLE
결제 완료 웹훅을 받을 때 이벤트 ID를 저장해 두고 같은 ID가 다시 오면 주문 상태를 또 바꾸지 않고 이미 처리됨 응답을 돌려준다. AI에게 정상 처리, 중복 수신, 실패 후 재시도 케이스를 테스트로 분리하게 하면 안전하다.
NOTES
HTTP GET처럼 원래 멱등적인 요청도 있지만, 실제 서비스에서는 POST 작업에도 별도 중복 방지 키를 두어 멱등하게 설계할 수 있다.
NEXT STEP
RELATED TERMS
HTTP (Hypertext Transfer Protocol)
브라우저와 서버가 요청과 응답을 주고받는 웹의 기본 통신 규칙이다. 사용자가 주소를 열면 브라우저가 HTTP 요청을 보내고, 서버는 HTML, JSON, 이미지 같은 응답을 돌려준다. 상태 코드 200, 404, 500과 GET, POST 같은 메서드는 웹 앱 디버깅의 가장 기본 언어이므로 바이브 코딩 초보자도 반드시 익혀야 한다.
백엔드·인프라 URLURL (Uniform Resource Locator)
웹에서 특정 페이지나 리소스의 위치를 나타내는 주소이다. 도메인, 경로, 쿼리 문자열 같은 부분으로 구성되며, 같은 앱 안에서도 /qna, /hermes, /vibe-dictionary처럼 경로에 따라 다른 화면이 열린다. AI에게 라우팅이나 링크 수정을 요청할 때 URL 구조를 이해하면 깨진 링크와 잘못된 리다이렉트를 더 빨리 찾을 수 있다.
백엔드·인프라 APIAPI (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의 표준화'이다.
NEXT STEP / PRACTICE