Documentation & REST API Specification

# 1. Fetch all active breeding animals
curl -X GET "https://breeder.cloud/api/v1/animals?status=ACTIVE" \
  -H "Authorization: Bearer bc_live_your_token_here"

# 2. Fetch public organization website template
curl -X GET "https://breeder.cloud/api/v1/organizations/highland-kennels/template"

# 3. Fetch CMS homepage with sections & columns
curl -X GET "https://breeder.cloud/api/v1/organizations/highland-kennels/pages/home"

// TypeScript Client Integration
interface Animal {
  id: string;
  name: string;
  nameFull?: string;
  sex?: "female" | "male" | "other" | "unknown";
  status: "ACTIVE" | "INACTIVE" | "FUTURE" | "RETIRED";
}

async function getBreederAnimals(): Promise<Animal[]> {
  const res = await fetch("https://breeder.cloud/api/v1/animals?status=ACTIVE", {
    headers: {
      Authorization: `Bearer ${process.env.BREEDER_CLOUD_API_TOKEN}`,
    },
    next: { revalidate: 60 }, // ISR caching for Next.js
  });

  if (!res.ok) throw new Error("Failed to fetch animals");
  const json = await res.json();
  return json.data;
}