Error handling

​

HTTP Status Codes

• 2xx - Success
• 4xx - Client errors (invalid request, authentication, etc.)
• 5xx - Server errors

​

Error Response Format

​

Error Code Categories

​

Retry Strategy

​

Recommended Retry Logic

const MAX_RETRIES = 3;
const BASE_DELAY = 1000; // 1 second

async function apiRequestWithRetry(request, attempt = 1) {
  try {
    return await makeRequest(request);
  } catch (error) {
    if (attempt >= MAX_RETRIES || !isRetryable(error)) {
      throw error;
    }

    const delay = BASE_DELAY * Math.pow(2, attempt - 1);
    await sleep(delay);
    return apiRequestWithRetry(request, attempt + 1);
  }
}

​

Retry Guidelines

• Exponential Backoff: Start with 1s, double each retry (1s, 2s, 4s)
• Jitter: Add randomization to prevent thundering herd
• Maximum Retries: Limit to 3 attempts for 5xx errors
• Non-Retryable: Do not retry 4xx errors (except 429)

​

Circuit Breaker Pattern

• Failure Threshold: 5 consecutive failures
• Timeout Period: 30 seconds
• Recovery: Gradual recovery with limited requests

​

Request Tracking

• Include this ID when contacting support
• Request IDs are retained for 30 days
• Correlate client-side errors with server-side logs