본문으로 건너뛰기

루프공방LoopLab

배우기 카탈로그 도구·모델 AI 질의 소식 챌린지 공유 방명록

페이지를 불러오는 중입니다.

루프공방

바이브코딩을 해 봤지만 아직 서툰 사람을 위해, 하네스·Skills·MCP·Hooks·실제 도구를 익히고 시행착오를 줄이는 학습 허브

검색 완전 초보 배우기 도구·모델 카탈로그 소식 챌린지 프로젝트 방명록 로그인

배우기
카탈로그
AI 질의
챌린지
공유

plugin실전API계약TS

OpenAPI + Zod 툴체인

계약 먼저 API

커뮤니티 · API 거버넌스 바이브

무엇을 하나요

OpenAPI 스펙 또는 zod에서 클라이언트를 생성해 계약 드리프트를 줄임.

어떻게 동작하나요

스펙 → 타입/클라이언트 생성 또는 zod → OpenAPI export. CI에서 드리프트 검사.

이런 분께

다중 클라이언트 API 팀.

시작 방법

공개 엔드포인트 3개만 스펙화.

실전 팁

브레이킹 변경 감지
예제 응답 포함
버전 정책 문서

이럴 땐 쓰지 마세요

내부 Prototyping only.

주의 (보안·운영)

생성 코드 수동 수정 금지.

막히기 쉬운 지점

스펙과 구현 이중 관리 방치.

같이 보면 좋은 항목

API 설계 스킬 — 엔드포인트·에러·버전 규칙 고정
Zod — 런타임 스키마 검증
tRPC — 엔드투엔드 타입 API