# Get all products (default pagination)
curl -X GET "{{host}}/api/v1/products" \
  -H "Authorization: Bearer your_access_token"

# Filter by category with custom pagination
curl -X GET "{{host}}/api/v1/products?category=Gift%20Cards&page=1&limit=20" \
  -H "Authorization: Bearer your_access_token"

# Sort by name in ascending order
curl -X GET "{{host}}/api/v1/products?sort=%7B%22field%22%3A%22name%22%2C%22direction%22%3A%22ASC%22%7D" \
  -H "Authorization: Bearer your_access_token"

<?php
// Get all products with default pagination
$products = $api->makeAuthenticatedRequest('{{host}}/api/v1/products');

foreach ($products as $product) {
    echo "Product: " . $product['name'] . " - " . $product['category'] . "\n";
}

// Filter by category with custom pagination
$params = http_build_query([
    'category' => 'Gift Cards',
    'page' => 1,
    'limit' => 20
]);

$giftCards = $api->makeAuthenticatedRequest(
    "{{host}}/api/v1/products?{$params}"
);

// Sort products by name in ascending order
$sortConfig = json_encode([
    'field' => 'name',
    'direction' => 'ASC'
]);

$sortedProducts = $api->makeAuthenticatedRequest(
    '{{host}}/api/v1/products?sort=' . urlencode($sortConfig)
);

// Build product catalog for display
echo "<div class='product-grid'>\n";
foreach ($sortedProducts as $product) {
    echo "<div class='product-card'>\n";
    echo "  <img src='" . htmlspecialchars($product['image_url']) . "'>\n";
    echo "  <h3>" . htmlspecialchars($product['name']) . "</h3>\n";
    echo "  <p>Category: " . htmlspecialchars($product['category']) . "</p>\n";
    echo "  <p>Delivery: " . htmlspecialchars($product['delivery_time']) . "</p>\n";
    echo "</div>\n";
}
echo "</div>\n";
?>

# Get basic product details
curl -X GET "{{host}}/api/v1/products/1001" \
  -H "Authorization: Bearer your_access_token"

# Get product with full details
curl -X GET "{{host}}/api/v1/products/1001" \
  -H "Authorization: Bearer your_access_token"

<?php
// Get detailed product information
try {
    $productId = 1001;
    $product = $api->makeAuthenticatedRequest(
        "{{host}}/api/v1/products/{$productId}"
    );
    
    // Display product details
    echo "<div class='product-details'>\n";
    echo "  <h1>" . htmlspecialchars($product['name']) . "</h1>\n";
    echo "  <img src='" . htmlspecialchars($product['image_url']) . "' alt='Product Image'>\n";
    echo "  <p><strong>Category:</strong> " . htmlspecialchars($product['category']) . "</p>\n";
    echo "  <p><strong>Delivery:</strong> " . htmlspecialchars($product['delivery_time']) . " via " . htmlspecialchars($product['delivery_type']) . "</p>\n";
    echo "  <p><strong>Validity:</strong> " . htmlspecialchars($product['validity']) . "</p>\n";
    
    if (!empty($product['details'])) {
        echo "  <div class='description'>\n";
        echo "    <h3>Description</h3>\n";
        echo "    <p>" . htmlspecialchars($product['details']) . "</p>\n";
        echo "  </div>\n";
    }
    
    if (!empty($product['how_to_use'])) {
        echo "  <div class='instructions'>\n";
        echo "    <h3>How to Use</h3>\n";
        echo "    <pre>" . htmlspecialchars($product['how_to_use']) . "</pre>\n";
        echo "  </div>\n";
    }
    
    // Display available denominations
    if (!empty($product['available_denominations'])) {
        echo "  <div class='denominations'>\n";
        echo "    <h3>Available Amounts</h3>\n";
        foreach ($product['available_denominations'] as $denom) {
            $discount = $denom['discount'] ?? 0;
            echo "    <p>Min: $" . number_format($denom['min_value'], 2) . " - ";
            echo "Max: $" . number_format($denom['max_value'], 2);
            if ($discount > 0) {
                echo " (" . $discount . "% discount)";
            }
            echo "</p>\n";
        }
        echo "  </div>\n";
    }
    
    echo "</div>\n";
    
} catch (Exception $e) {
    echo "Error loading product: " . $e->getMessage() . "\n";
}
?>

# Check if product is available
curl -X POST "{{host}}/api/v1/products/1001/availability" \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "denomination": 100.00,
    "quantity": 2
  }'

# Check large quantity availability
curl -X POST "{{host}}/api/v1/products/1001/availability" \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "denomination": 50.00,
    "quantity": 100
  }'

<?php
// Check product availability before showing purchase options
function checkProductAvailability($api, $productId, $denomination, $quantity = 1) {
    try {
        $requestData = [
            'denomination' => $denomination,
            'quantity' => $quantity
        ];
        
        $result = $api->makeAuthenticatedRequest(
            "{{host}}/api/v1/products/{$productId}/availability",
            'POST',
            $requestData
        );
        
        return $result['is_available'] ?? false;
    } catch (Exception $e) {
        error_log("Availability check failed: " . $e->getMessage());
        return false;
    }
}

// Example usage: Check availability for different scenarios
$productId = 1001;

// Standard purchase check
if (checkProductAvailability($api, $productId, 100.00, 2)) {
    echo "<button class='btn-primary'>Buy 2 x $100 Gift Cards</button>\n";
} else {
    echo "<button class='btn-disabled' disabled>Currently Unavailable</button>\n";
}

// Bulk purchase check
if (checkProductAvailability($api, $productId, 50.00, 100)) {
    echo "<p class='stock-status available'>✓ Bulk orders available</p>\n";
} else {
    echo "<p class='stock-status unavailable'>Warning: Bulk orders currently unavailable</p>\n";
}

// Build availability matrix for different denominations
$denominations = [25, 50, 100, 250, 500];

echo "<div class='availability-matrix'>\n";
echo "  <h3>Availability Status</h3>\n";
echo "  <table>\n";
echo "    <thead><tr><th>Amount</th><th>Status</th></tr></thead>\n";
echo "    <tbody>\n";

foreach ($denominations as $amount) {
    $available = checkProductAvailability($api, $productId, $amount, 1);
    $status = $available ? '✓ Available' : '✗ Unavailable';
    $class = $available ? 'available' : 'unavailable';
    
    echo "      <tr>\n";
    echo "        <td>$" . number_format($amount) . "</td>\n";
    echo "        <td class='{$class}'>{$status}</td>\n";
    echo "      </tr>\n";
}

echo "    </tbody>\n";
echo "  </table>\n";
echo "</div>\n";
?>