API Best Practices

async function fetchWithRetry(url, maxRetries = 5) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url);

    if (response.status === 429) {
      const waitTime = Math.pow(2, i) * 1000;
      await sleep(waitTime);
      continue;
    }

    return response;
  }
  throw new Error('Max retries exceeded');
}

class DataDockedClient {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://api.datadocked.com/api/v1';
  }

  async request(endpoint, options = {}) {
    const maxRetries = 3;
    let lastError;

    for (let attempt = 0; attempt < maxRetries; attempt++) {
      try {
        const response = await fetch(`${this.baseUrl}${endpoint}`, {
          ...options,
          headers: {
            'Authorization': `Bearer ${this.apiKey}`,
            'Content-Type': 'application/json',
            ...options.headers,
          },
        });

        // Rate limited — back off exponentially
        if (response.status === 429) {
          const waitMs = Math.pow(2, attempt) * 1000;
          await this.sleep(waitMs);
          continue;
        }

        // Server error — retry with backoff
        if (response.status >= 500) {
          const waitMs = Math.pow(2, attempt) * 1000;
          await this.sleep(waitMs);
          continue;
        }

        // Success or client error — return as-is
        return response.json();

      } catch (error) {
        lastError = error;
        const waitMs = Math.pow(2, attempt) * 1000;
        await this.sleep(waitMs);
      }
    }

    throw lastError || new Error('Request failed after retries');
  }

  sleep(ms) {
    return new Promise(resolve => setTimeout(resolve, ms));
  }

  // Get single vessel
  async getVessel(mmsi) {
    return this.request(`/vessel/${mmsi}`);
  }

  // Get vessels in area
  async getVesselsInArea(bounds) {
    const { latMin, latMax, lonMin, lonMax } = bounds;
    return this.request(
      `/vessels/area?lat_min=${latMin}&lat_max=${latMax}&lon_min=${lonMin}&lon_max=${lonMax}`
    );
  }
}

// Usage
const client = new DataDockedClient('your_api_key');
const vessel = await client.getVessel('211234567');