GET /api/products

{
  "products": [
    {
      "id": "prod_123456",
      "name": "Serenity Candle",
      "description": "A calming blend of lavender and chamomile",
      "price": 24.99,
      "images": [
        {
          "url": "https://example.com/images/candle1.jpg",
          "alt": "Serenity Candle product image"
        }
      ],
      "category": "candles",
      "inStock": true,
      "variants": [
        {
          "id": "var_789012",
          "name": "Small",
          "price": 24.99,
          "sku": "SER-CAN-S"
        },
        {
          "id": "var_789013",
          "name": "Large",
          "price": 34.99,
          "sku": "SER-CAN-L"
        }
      ],
      "createdAt": "2023-01-10T09:00:00Z",
      "updatedAt": "2023-03-15T14:30:00Z"
    },
    // Additional products...
  ],
  "pagination": {
    "total": 48,
    "pages": 3,
    "page": 1,
    "limit": 20
  }
}

GET /api/products/{productId}

{
  "id": "prod_123456",
  "name": "Serenity Candle",
  "description": "A calming blend of lavender and chamomile",
  "detailedDescription": "Our Serenity Candle combines the soothing properties of lavender and chamomile to create a peaceful atmosphere in any space. Hand-poured with 100% soy wax and featuring a cotton wick for a clean burn.",
  "price": 24.99,
  "images": [
    {
      "url": "https://example.com/images/candle1.jpg",
      "alt": "Serenity Candle product image"
    },
    {
      "url": "https://example.com/images/candle1-detail.jpg",
      "alt": "Serenity Candle detail image"
    }
  ],
  "category": "candles",
  "tags": ["relaxation", "sleep", "aromatherapy"],
  "ingredients": ["Soy wax", "Essential oils", "Cotton wick"],
  "specifications": {
    "weight": "8 oz",
    "dimensions": "3 x 3 x 4 inches",
    "burnTime": "40 hours"
  },
  "inStock": true,
  "inventory": 45,
  "variants": [
    {
      "id": "var_789012",
      "name": "Small",
      "price": 24.99,
      "sku": "SER-CAN-S",
      "inventory": 25
    },
    {
      "id": "var_789013",
      "name": "Large",
      "price": 34.99,
      "sku": "SER-CAN-L",
      "inventory": 20
    }
  ],
  "relatedProducts": ["prod_234567", "prod_345678"],
  "createdAt": "2023-01-10T09:00:00Z",
  "updatedAt": "2023-03-15T14:30:00Z"
}

POST /api/admin/products

{
  "name": "Energize Bath Bomb",
  "description": "Revitalizing citrus bath bomb",
  "detailedDescription": "Transform your bath with invigorating citrus scents...",
  "price": 12.99,
  "category": "bath",
  "tags": ["energizing", "morning", "citrus"],
  "ingredients": ["Sodium bicarbonate", "Citric acid", "Essential oils"],
  "specifications": {
    "weight": "5.5 oz",
    "dimensions": "2.5 inch diameter"
  },
  "inventory": 100,
  "variants": [
    {
      "name": "Single",
      "price": 12.99,
      "sku": "ENE-BB-S",
      "inventory": 75
    },
    {
      "name": "3-Pack",
      "price": 34.99,
      "sku": "ENE-BB-3P",
      "inventory": 25
    }
  ]
}

{
  "id": "prod_567890",
  "name": "Energize Bath Bomb",
  "description": "Revitalizing citrus bath bomb",
  "price": 12.99,
  // ... other fields from the request
  "inStock": true,
  "variants": [
    {
      "id": "var_901234",
      "name": "Single",
      "price": 12.99,
      "sku": "ENE-BB-S",
      "inventory": 75
    },
    {
      "id": "var_901235",
      "name": "3-Pack",
      "price": 34.99,
      "sku": "ENE-BB-3P",
      "inventory": 25
    }
  ],
  "createdAt": "2023-04-16T11:00:00Z",
  "updatedAt": "2023-04-16T11:00:00Z"
}

PATCH /api/admin/products/{productId}

{
  "price": 14.99,
  "inventory": 85,
  "tags": ["energizing", "morning", "citrus", "self-care"]
}

{
  "id": "prod_567890",
  "name": "Energize Bath Bomb",
  "description": "Revitalizing citrus bath bomb",
  "price": 14.99,
  // ... other unchanged fields
  "tags": ["energizing", "morning", "citrus", "self-care"],
  "inventory": 85,
  "updatedAt": "2023-04-16T14:20:00Z"
}

DELETE /api/admin/products/{productId}

{
  "success": true,
  "message": "Product successfully deleted",
  "id": "prod_567890"
}