hey-api/openapi-ts

OpenAPI 사양을 TypeScript SDK, Zod 스키마, TanStack Query 훅으로 자동 생성하는 프로덕션급 코드젠 도구

설치형 도구맘대로 써도 됨 · MIT웹·Next.js·풀스택난이도
4,968+0이번 주382400TypeScript
데모·홈페이지 열기heyapi.dev
중간맛 분석

스택: TypeScript, Node.js 22+, OpenAPI 3.0/3.1 | 난이도: 낮음 ( 한 줄로 시작 가능) | 즉시 활용: npx @hey-api/openapi-ts -i <스펙> -o src/client 명령으로 타입 안전한 클라이언트 생성 | 데모: Stackblitz에서 실시간 코드 생성 결과 확인 가능 | 플러그인: Zod/Valibot 스키마, TanStack Query/Pinia Colada 훅, Fastify/NestJS 서버 코드도 함께 생성

이런 레포예요

이럴 때 쓰면 좋아요

  • REST API 클라이언트를 자동으로 생성하고 타입 안전성 확보
  • Zod/Valibot 런타임 검증 스키마를 OpenAPI에서 자동 생성
  • React Query/Vue Query 같은 데이터 페칭 라이브러리용 훅 자동 생성

핵심 기능

OpenAPI → 타입 안전한 TypeScript SDK 자동 생성Fetch/Axios/Angular/Next.js/Nuxt 등 7개 HTTP 클라이언트 지원Zod, Valibot, TanStack Query 등 20+ 플러그인으로 보일러플레이트 자동화

대안 대비 차별점

TypeScript 생태계에 최적화된 경량 설계로 Zod/TanStack Query 같은 현대 라이브러리와 원활히 통합되며, 단순 타입 생성을 넘어 런타임 검증 스키마와 상태 관리 훅까지 한 번에 생성할 수 있는 유일한 도구

준비물
  • Node.js 22+
  • 유효한 OpenAPI 사양 (파일, URL, 또는 객체 형태)
바로 시작하기
  1. npm/pnpm/yarn/bun으로 패키지 설치
npm install @hey-api/openapi-ts -D -E
  1. package.json에 스크립트 추가
{
  "scripts": {
    "openapi-ts": "openapi-ts"
  }
}
  1. 프로젝트 루트에 설정 파일 생성 (openapi-ts.config.ts)
import { defineConfig } from '@hey-api/openapi-ts';

export default defineConfig({
  input: 'hey-api/backend',
  output: 'src/client',
});
  1. CLI로 코드 생성 실행
npm run openapi-ts
  1. 생성된 타입과 SDK 파일을 프로젝트에서 import하여 사용
별 추이 · 7일
4,968+0 / 7일
활용성 · 따라 만들기 좋은가
따라 하기 좋음샘플 점수 50/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2024년 생성

AI가 README 기반으로 요약했습니다 · 원문 보기