apollo-common-errors

# Apollo Common Errors ## Overview Comprehensive guide to diagnosing and fixing Apollo.io API errors. Apollo uses `x-api-key` header authentication and the base URL `https://api.apollo.io/api/v1/`. Apollo distinguishes between **master** and **standard** API keys — many endpoints require master keys. ## Prerequisites - Valid Apollo.io API credentials - Node.js 18+ or Python 3.10+ ## Instructions ### Step 1: Identify the Error Category ```typescript // src/apollo/error-handler.ts import { AxiosError } from 'axios'; type ErrorCategory = 'auth' | 'permission' | 'rate_limit' | 'validation' | 'server' | 'network'; function categorizeError(err: AxiosError): ErrorCategory { if (!err.response) return 'network'; switch (err.response.status) { case 401: return 'auth'; case 403: return 'permission'; case 429: return 'rate_limit'; case 400: case 422: return 'validation'; default: return err.response.status >= 500 ? 'server' : 'validation'; } } ``` ### Step 2: Handle 401 — Invalid API Key ```typescript // Most common cause: missing x-api-key header or wrong key format async function diagnoseAuth() { try { const response = await fetch('https://api.apollo.io/api/v1/auth/health', { headers: { 'x-api-key': process.env.APOLLO_API_KEY! }, }); const data = await response.json(); if (data.is_logged_in) { console.log('API key is valid'); } else { console.error('API key is invalid or expired'); console.error(' Generate ...