SuperAPI AI 工具集

apollo-local-dev-loop

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:为 Apollo.io 集成建立高效的本地开发工作流,便于配置开发环境、本地测试 API 调用并统一团队开发方式。

主要能力:支持沙箱 API Key(不消耗信用、返回虚拟数据);提供带请求/响应日志与速率限制显示的开发客户端;使用 MSW 模拟服务实现离线测试,覆盖人员搜索、人员富化、组织富化、序列搜索与认证健康检查;配置 Vitest 并附带 mock 服务的启动与清理。

使用方式:先完成 apollo-install-auth 设置,需要 Node.js 18+ 和已初始化的 Git 仓库。步骤包括:创建 .env.example 与 .env(沙箱 Key 在 Settings > Integrations > API Keys > Sandbox 生成,.env 需加入 .gitignore);创建 src/apollo/dev-client.ts 并加入日志拦截器;建立 MSW handlers 与 server;配置 vitest.config.ts 与 setup 文件;在 package.json 添加脚本,如 "dev": "tsx watch src/index.ts"、"test": "vitest"、"test:watch"、"test:sandbox"、"apollo:check"、"apollo:search"。

适用场景:新增人员搜索等改动时,先跑 MSW 单元测试,仅断言合成数据字段;通过后再用 APOLLO_USE_SANDBOX=true 做窄范围连通性检查。日志只关注端点、状态与请求字段名,不打印联系人值、密钥或完整错误负载。

限制:若沙箱 Key 缺失、mock 被绕过或意外走真实信用路径,应中止并恢复纯 mock 设置。常见问题:缺少 API Key(.env 未加载)、mock 失效(MSW 未配置)、意外消耗信用(沙箱模式关闭)、凭据过期(需运行 npm run apollo:check 验证)。资料未提供具体收费、价格与效果信息。