用途:指导升级 @hubspot/api-client SDK,并在 HubSpot 旧 API 与当前 CRM v3 API 之间迁移。适用于升级 Node.js SDK、从 v1/v2 迁移到 v3,以及处理各版本破坏性变更。
主要能力:检查当前与最新版本及变更日志;审查破坏性变更(v11→v12 关联 API 迁至 v4 命名空间 client.crm.associations.v4.basicApi;v10→v11 批量 API 输入改为 { inputs: [...] };v9→v10 移除 apiKey 认证,改用 accessToken;v8→v9 全方法启用严格 TypeScript 类型);提供 API Key 到 Access Token、关联 v3 到 v4、旧联系人/交易接口到 CRM v3 的迁移模式;识别代码中遗留端点。
使用方式:先运行 npm list @hubspot/api-client、npm view @hubspot/api-client version 查看版本,随后 git checkout -b chore/upgrade-hubspot-api-client、npm install @hubspot/api-client@latest、npm test,再按破坏性变更逐一迁移,最后合并提交并记录回滚方案。
前置条件:已安装当前 SDK、Git、可用测试套件及用于验证的预发布环境。
限制:资料未提供具体版本号、时间线、价格与支持范围;回滚使用 npm install @hubspot/api-client@PREVIOUS_VERSION --save-exact。