用途:围绕 Vercel REST API(api.vercel.com)构建类型化、可用于生产的封装,覆盖认证、分页、错误处理、重试逻辑,以及部署、项目、环境变量等常见端点模式。
主要能力:创建带类型的 API 客户端(VercelClient),支持 token、teamId、baseUrl 配置;定义项目、部署、环境变量、域名等 TypeScript 类型;自定义 VercelApiError 错误类,提供 isRateLimit、isNotFound、isUnauthorized 等语义判断;对 429 响应使用指数退避重试(withRetry);对大量结果使用异步生成器分页(paginateDeployments)。
使用方式:前置条件为完成 vercel-install-auth 设置、启用 strict 模式的 TypeScript 项目、具备适当范围的 Vercel 访问令牌。按步骤创建客户端、定义类型、错误类、重试与分页工具,再调用 listProjects、getProject、listDeployments、getDeployment、listEnvVars、createEnvVar、listDomains、addDomain 等方法。
适用场景:以编程方式集成 Vercel API、构建部署审计或自动化管理工具。
限制:资料未提供具体安装命令、价格、平台支持范围或性能数据;示例中部分分页参数(如 until)与客户端方法签名存在不一致,实际使用需以 Vercel 官方 API 文档为准。