Getting Started with the API

{
  "id": 123,
  "name": "Max",
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "status": "available",
  "age": 2,
  "breed": "Labrador",
  "description": "Friendly and energetic dog, great with kids",
  "photoUrls": [],
  "tags": [],
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

async function updatePetStatus(petId, newStatus) {
  const updateData = {
    status: newStatus
  };

  const response = await fetch(`https://api.acme.com/v1/pets/${petId}`, {
    method: 'PUT',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(updateData)
  });

  if (response.ok) {
    const updatedPet = await response.json();
    console.log(`Pet ${updatedPet.name} status updated to: ${updatedPet.status}`);
    return updatedPet;
  } else {
    throw new Error(`Failed to update pet: ${response.status}`);
  }
}

// Usage examples
await updatePetStatus(123, 'pending'); // Mark as adoption in progress
await updatePetStatus(456, 'sold');    // Mark as successfully adopted

const response = await fetch('https://api.acme.com/v1/categories', {
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const { categories } = await response.json();

categories.forEach(category => {
  console.log(`${category.id}: ${category.name} - ${category.description}`);
});

{
  "categories": [
    {
      "id": 1,
      "name": "Dogs",
      "description": "All types of dogs"
    },
    {
      "id": 2, 
      "name": "Cats",
      "description": "All types of cats"
    },
    {
      "id": 3,
      "name": "Birds",
      "description": "All types of birds"
    }
  ]
}

class OptimizedPetStoreAPI extends PetStoreAPI {
  constructor(apiKey) {
    super(apiKey);
    this.cache = new Map();
    this.cacheTimeout = 5 * 60 * 1000; // 5 minutes
  }

  // Cache frequently accessed data
  async getCachedPet(id) {
    const cacheKey = `pet_${id}`;
    const cached = this.cache.get(cacheKey);
    
    if (cached && Date.now() - cached.timestamp < this.cacheTimeout) {
      return cached.data;
    }

    const pet = await this.getPet(id);
    this.cache.set(cacheKey, {
      data: pet,
      timestamp: Date.now()
    });

    return pet;
  }

  // Batch multiple pet requests
  async getMultiplePets(ids) {
    const promises = ids.map(id => this.getCachedPet(id));
    return Promise.all(promises);
  }

  // Intelligent pagination
  async getAllPetsInCategory(categoryName, batchSize = 50) {
    const allPets = [];
    let offset = 0;
    let hasMore = true;

    while (hasMore) {
      const result = await this.getPets({
        category: categoryName,
        limit: batchSize,
        offset: offset
      });

      allPets.push(...result.pets);
      hasMore = result.pagination.hasMore;
      offset += batchSize;

      // Add small delay to be respectful of rate limits
      if (hasMore) {
        await new Promise(resolve => setTimeout(resolve, 100));
      }
    }

    return allPets;
  }
}