OpenAPI 转 TypeScript 生成器

使用方法

1. 将 OpenAPI 3.0.x 或 3.1.x 文档（YAML 或 JSON）粘贴到左侧面板。
2. 输入后会以 300 ms 防抖实时生成类型。
3. 可选：调整 根命名空间、把所有属性标记为可选、附加 path 操作类型、或同时输出 Zod schema。
4. 点击 复制 即可拿到完整的 TypeScript 输出。

生成内容

• components/schemas：每个 schema 输出一个 export interface 或 export type，对象类型用 interface，基本/联合/枚举/交叉类型用 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 schema（可选）

勾选 包含 Zod schema，会为每个 component 输出同名 XSchema：

import { z } from 'zod';

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

若你的项目是从手写 TS 类型反推 Zod，可改用 TypeScript 转 Zod。

相关工具

• OpenAPI 验证器 — 生成类型前先校验规范。
• JSON 转 TypeScript — 只有 JSON 响应样本、没有完整规范时使用。
• JSON 转 Zod Schema — 从单个 JSON 示例生成 Zod。