heyapi.dev

是什么

Hey API 的核心工具 @hey-api/openapi-ts 用于从 OpenAPI specifications 生成 TypeScript 代码。官方定位是“OpenAPI to code in seconds”，可将规范转换为生产级代码，运行于 Node.js 22+ 环境，并支持任意 OpenAPI specification。正文提到其被 Vercel、OpenCode、PayPal 等公司使用，但测评仍以其公开文档能力为准。

核心能力与生态

它的主要价值在于插件化代码生成：核心插件覆盖 SDK、types、schemas；HTTP clients 支持 Fetch API、Angular、Axios、Ky、Next.js、Nuxt、OFetch、Effect 等；验证器生态包含 Valibot、Zod、Ajv 等；状态管理方向列出 Pinia Colada、TanStack Query、SWR；Mock 与 Web Frameworks 也有对应插件入口。接入方式较灵活，既可通过 npx 或 npm script 使用 CLI，也可在 JS/TS 中调用 createClient()，还提供 @hey-api/vite-plugin 集成 Vite 5 到 8 的构建流程。

定价与部署

抓取正文没有披露定价、付费套餐、支付方式或企业支持信息。文中提到可同步 Hey API Registry 做 spec management，并提示 input 示例需要在 app.heyapi.dev 注册，但未说明是否支持自托管、私有化部署或离线 Registry。因此在采购或企业落地前，需要进一步确认商业条款、数据存储位置与权限管理能力。

优缺点

优点是定位清晰、安装简单，支持 npm、pnpm、yarn、bun；文档结构完整，包含配置、输出、插件、迁移、License、Roadmap 等入口；生态覆盖面广，能减少前端 API 客户端和验证层样板代码。限制在于它主要面向 TypeScript/Node.js，未看到其他语言生成能力；官方说明 package 仍处于 initial development，并建议锁定精确版本，说明版本稳定性和破坏性升级需要纳入工程治理。

适合谁与中国访问

它适合以 OpenAPI 作为契约、前后端分离、重视 TypeScript 类型安全的团队，尤其是 Vite、Next.js、Nuxt、Axios、Fetch 或 TanStack Query 用户。中国访问情况正文无依据，判定为未知；若 app.heyapi.dev、GitHub、npm 访问不稳定，可考虑使用 npm 镜像，并评估 OpenAPI Generator、Swagger Codegen、Orval、Kiota 等替代品。