用途:面向 Apollo.io API 集成排障,帮助识别错误类别并给出对应的修复动作与安全边界。
主要能力:按 HTTP 状态错误分类为 auth、permission、rate_limit、validation、server、network;401 对应 x-api-key 缺失或失效,403 对应使用了仅标准权限密钥而端点要求 master 密钥,429 对应速率限制,422 对应请求体校验失败,5xx 与 ECONNREFUSED 分别指向服务端与网络防火墙问题。资料列出需 master 密钥的端点,如 POST /contacts、POST /emailer_campaigns/search、POST /emailer_campaigns/{id}/add_contact_ids、POST /opportunities、POST /tasks、DELETE /contacts/{id}。速率限制按端点类别给出固定窗口,如 People Search、People Enrichment、Organization Enrichment、Contacts CRUD、Sequences 为 100/min(突发 10/sec),Bulk People Enrichment 为 10/min(突发 2/sec)。
使用方式:以 x-api-key 请求头认证,基础 URL 为 https://api.apollo.io/api/v1/。可用 cURL 做最小诊断,例如 curl -s -H "x-api-key: $APOLLO_API_KEY" https://api.apollo.io/api/v1/auth/health 检查密钥是否有效;资料另给出以 Axios 拦截器统一分类错误、按 Retry-After 退避重试的示例。
限制与安全:不要用 api_key 查询参数替代请求头;密钥可能被撤销、重新生成或含尾部空白。429 应遵守 Retry-After 并限制重试次数;5xx 或网络失败不应盲目重放可能已生效的写操作。日志中不得写入 Apollo 密钥、原始联系人数据或完整请求体;遇到 403 不得通过调试分支扩大标准密钥权限。资料未提供具体价格、套餐与官方支持政策。