OpenAPI → TypeScript 생성기

사용 방법

1. OpenAPI 3.0.x 또는 3.1.x 문서(YAML 또는 JSON)를 왼쪽 패널에 붙여 넣습니다.
2. 입력하면 300 ms 디바운스로 실시간 생성됩니다.
3. 선택적으로 루트 네임스페이스 변경, 모든 속성을 optional 처리, path 오퍼레이션 타입 포함, Zod 스키마 동시 출력을 선택할 수 있습니다.
4. 복사 버튼으로 전체 TypeScript 출력을 가져갑니다.

생성되는 내용

• components/schemas: 각 스키마가 export interface 또는 export type이 됩니다. 객체는 interface, 기본형 / 유니언 / enum / 교차 타입은 type alias로 출력됩니다.
• $ref: #/components/schemas/... 참조는 타입 이름으로 해석되며, 스펙의 선언 순서를 그대로 따릅니다.
• oneOf / anyOf: 유니언 타입 A | B | C. allOf는 교차 타입 A & B.
• enum: 문자열 또는 숫자 리터럴 유니언.
• nullable: 3.0의 nullable: true와 3.1의 type: ['X', 'null'] 모두 X | null로 변환.
• format 힌트: format: date-time에는 ISO 8601 JSDoc 주석을 추가하고, format: binary는 Blob이 됩니다.
• additionalProperties: 인덱스 시그니처 또는 Record<string, T>.

Path 타입(선택)

path 타입 포함을 켜면 각 오퍼레이션마다 타입 엔벨로프가 생성됩니다:

export namespace Components {
export namespace GetPetById {
  export interface PathParameters {
    id: number;
  }
  export type Response200 = Pet;
}
}

오퍼레이션에 operationId가 없으면 method와 path로 합성합니다(예: GetPetsId).

Zod 스키마(선택)

Zod 스키마 포함을 켜면 각 컴포넌트별로 XSchema를 함께 출력합니다:

import { z } from 'zod';

export const PetSchema = z.object({
id: z.number().int(),
name: z.string(),
status: z.enum(["available", "pending", "sold"]),
});

OpenAPI 스펙이 아니라 손으로 쓴 TS 타입에서 Zod를 만들고 싶다면 TypeScript → Zod를 사용하세요.

관련 도구

• OpenAPI 유효성 검사기 — 타입 생성 전 스펙을 검증.
• JSON → TypeScript — 스펙은 없고 JSON 응답 샘플만 있을 때.
• JSON → Zod 스키마 — 단일 JSON 예시에서 Zod 생성.