Product API Guide

// List products with filters
async function getProducts(filters = {}) {
  const params = new URLSearchParams({
    page: filters.page || 1,
    per_page: filters.perPage || 20,
    ...filters
  });
  
  const response = await fetch(`/api/v1/products?${params}`);
  const data = await response.json();
  
  if (data.status === 'success') {
    return data.data;
  } else {
    throw new Error(data.message);
  }
}

// Get product details
async function getProduct(id, options = {}) {
  const params = new URLSearchParams();
  if (options.includeRelated) params.append('include_related', 'true');
  if (options.includeReviews) params.append('include_reviews', 'true');
  if (options.includeVariants) params.append('include_variants', 'true');
  
  const response = await fetch(`/api/v1/products/${id}?${params}`);
  const data = await response.json();
  
  return data.data.product;
}

// Search products
async function searchProducts(query, filters = {}) {
  const params = new URLSearchParams({
    q: query,
    ...filters
  });
  
  const response = await fetch(`/api/v1/products/search?${params}`);
  const data = await response.json();
  
  return data.data;
}

// Usage examples
const products = await getProducts({
  category_id: 5,
  min_price: 100,
  max_price: 500,
  featured: true,
  order_by: 'price',
  direction: 'asc'
});

const product = await getProduct(123, {
  includeRelated: true,
  includeReviews: true,
  includeVariants: true
});

const searchResults = await searchProducts('wireless', {
  min_price: 100,
  per_page: 10
});

async function getProductSafely(id) {
  try {
    const response = await fetch(`/api/v1/products/${id}`);
    const data = await response.json();
    
    if (data.status === 'success') {
      return data.data.product;
    } else {
      // Handle specific error codes
      switch (data.error_code) {
        case 'NOT_FOUND':
          console.error('Product not found');
          break;
        case 'BAD_REQUEST':
          console.error('Invalid request:', data.message);
          break;
        default:
          console.error('Error:', data.message);
      }
      throw new Error(data.message);
    }
  } catch (error) {
    console.error('Request failed:', error);
    throw error;
  }
}

// Good: Paginated request
const products = await getProducts({ page: 1, per_page: 20 });

// Bad: Requesting all products at once
const products = await getProducts({ per_page: 1000 });

// Check cache headers
const response = await fetch('/api/v1/products');
const cacheControl = response.headers.get('Cache-Control');

const response = await fetch('/api/v1/products');
if (!response.ok) {
  const error = await response.json();
  // Handle error appropriately
}

// Good: Filtered request
const products = await getProducts({
  category_id: 5,
  min_price: 100,
  max_price: 500
});

// Bad: Fetch all then filter client-side
const allProducts = await getProducts();
const filtered = allProducts.filter(p => p.category.id === 5);

// Good: Request only what you need
const product = await getProduct(123, { includeReviews: true });

// Bad: Request everything
const product = await getProduct(123, {
  includeRelated: true,
  includeReviews: true,
  includeVariants: true
});

async function fetchWithRetry(url, options = {}, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }
    
    return response;
  }
  throw new Error('Max retries exceeded');
}