API Errors

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_email_format",
    "message": "The email address is not valid.",
    "field": "from_address",
    "fix": "Use a valid email address format like user@example.com.",
    "doc_url": "https://docs.reachscore.co/docs/api/errors#invalid_email_format",
    "request_id": "req_abc123xyz"
  }
}

async function createTest(params) {
  try {
    const response = await fetch('https://api.reachscore.co/v1/tests', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(params),
    });

    if (!response.ok) {
      const data = await response.json();
      const error = data.error;

      switch (error.type) {
        case 'authentication_error':
          throw new Error('Invalid API key. Please check your credentials.');

        case 'invalid_request_error':
          throw new Error(`Validation error on ${error.field}: ${error.message}`);

        case 'rate_limit_error':
          const retryAfter = response.headers.get('Retry-After');
          throw new Error(`Rate limited. Retry after ${retryAfter}s`);

        case 'quota_exceeded':
          throw new Error('Monthly limit reached. Upgrade your plan.');

        default:
          throw new Error(error.message);
      }
    }

    return await response.json();
  } catch (err) {
    console.error('API Error:', err);
    throw err;
  }
}