用途:为 Apollo.io REST API 完成认证初始化,配置 API 密钥并验证连接。Apollo 无官方 SDK,全部通过直接调用 REST API,基址为 https://api.apollo.io/api/v1/,认证使用 x-api-key 请求头。
前置条件:Node.js 18+ 或 Python 3.10+;包管理器(npm、pnpm 或 pip);具备 API 访问权限的 Apollo.io 账户(Basic 计划或以上);在 Apollo 仪表盘 Settings > Integrations > API Keys 获取密钥。
主要能力:安装 HTTP 客户端依赖(Node.js 用 npm install axios dotenv,Python 用 pip install requests python-dotenv);通过 .env 存放 APOLLO_API_KEY 并将其加入 .gitignore;生成 TypeScript 或 Python 客户端,统一设置 Content-Type、Cache-Control 与 x-api-key 头,超时 30 秒;调用 /auth/health 并依据 is_logged_in 判断密钥是否有效。
密钥类型:Master API key 可访问全部端点(contacts、sequences、deals 等必需);Standard API key 仅限搜索与数据增强。
使用方式:先安装依赖与创建 .env,再按示例创建客户端,最后运行验证脚本或使用 cURL 直接请求 /auth/health 检查。
错误处理:401 表示密钥无效或缺失,需在仪表盘重新生成;403 表示端点需要 master key;429 为触发速率限制,需要退避重试;网络错误多为防火墙阻断出站 HTTPS,需放行到 api.apollo.io 的 443 端口。
限制:需已有 Apollo.io 账户及对应计划;未提供官方 SDK;未提供具体价格、速率数值或其他未列出的功能说明。