GET /get-variant

GET https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant

curl https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant \
  -H "x-testly-auth: YOUR_API_KEY" \
  -G \
  --data-urlencode "experiment_key=homepage-hero-test" \
  --data-urlencode "user_id=user_123"

curl "https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant?experiment_key=homepage-hero-test&user_id=user_123&apikey=YOUR_API_KEY"

{
  "variant_key": "variant-b",
  "variant_id": "550e8400-e29b-41d4-a716-446655440000",
  "experiment_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "variant_key": null,
  "reason": "experiment_not_running"
}

{
  "variant_key": null,
  "reason": "no_variants"
}

{
  "error": "Missing params or auth",
  "details": {
    "experimentKey": false,
    "userId": true,
    "apiKey": true
  }
}

{
  "error": "Invalid API Key"
}

async function getVariant(experimentKey, userId) {
  const response = await fetch(
    `https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant?experiment_key=${experimentKey}&user_id=${userId}`,
    {
      headers: {
        'x-testly-auth': 'YOUR_API_KEY'
      }
    }
  );

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }

  return response.json();
}

// Uso
const result = await getVariant('homepage-hero-test', 'user_123');
console.log('Variante:', result.variant_key);

import requests

def get_variant(experiment_key, user_id, api_key):
    response = requests.get(
        'https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant',
        params={
            'experiment_key': experiment_key,
            'user_id': user_id
        },
        headers={
            'x-testly-auth': api_key
        }
    )
    response.raise_for_status()
    return response.json()

# Uso
result = get_variant('homepage-hero-test', 'user_123', 'YOUR_API_KEY')
print(f"Variante: {result['variant_key']}")

<?php
function getVariant($experimentKey, $userId, $apiKey) {
    $url = 'https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant?' . http_build_query([
        'experiment_key' => $experimentKey,
        'user_id' => $userId
    ]);

    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "x-testly-auth: $apiKey"
    ]);
    
    $response = curl_exec($ch);
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($statusCode !== 200) {
        throw new Exception("HTTP $statusCode: $response");
    }
    
    return json_decode($response, true);
}

// Uso
$result = getVariant('homepage-hero-test', 'user_123', 'YOUR_API_KEY');
echo "Variante: " . $result['variant_key'];
?>

# Com header (recomendado)
curl -H "x-testly-auth: YOUR_API_KEY" \
  "https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant?experiment_key=homepage-hero-test&user_id=user_123"

# Com query param
curl "https://lfhltqrtfwxoirjmhcdz.supabase.co/functions/v1/get-variant?experiment_key=homepage-hero-test&user_id=user_123&apikey=YOUR_API_KEY"

hash = soma dos char codes de (user_id + experiment_key)
total_weight = soma de todos os traffic_weights das variantes
bucket = hash % total_weight

Exemplo:
user_id = "user_123"
experiment_key = "homepage-hero"
hash = 1234 (calculado)
total_weight = 100 (50 + 50)
bucket = 1234 % 100 = 34

Se bucket < 50 → Variante A
Se bucket >= 50 → Variante B

// Cache em memória
const variantCache = new Map();

async function getVariantCached(experimentKey, userId) {
  const cacheKey = `${experimentKey}:${userId}`;
  
  if (variantCache.has(cacheKey)) {
    return variantCache.get(cacheKey);
  }
  
  const result = await getVariant(experimentKey, userId);
  variantCache.set(cacheKey, result);
  
  return result;
}

// Next.js App Router
export async function generateMetadata({ params }) {
  const userId = cookies().get('user_id')?.value || 'anonymous';
  
  const { variant_key } = await getVariant('homepage-hero', userId);
  
  return {
    title: variant_key === 'variant-b' 
      ? 'Experimente Agora - Testly'
      : 'Comece Grátis - Testly'
  };
}

// Express.js middleware
app.use(async (req, res, next) => {
  const userId = req.cookies.user_id || 'anonymous';
  
  try {
    const { variant_key } = await getVariant('pricing-test', userId);
    req.testlyVariant = variant_key;
  } catch (error) {
    console.error('Testly error:', error);
    req.testlyVariant = null; // Fallback
  }
  
  next();
});

app.get('/pricing', (req, res) => {
  if (req.testlyVariant === 'variant-b') {
    res.render('pricing-3-col');
  } else {
    res.render('pricing-2-col');
  }
});

// Vercel Edge Function
export const config = { runtime: 'edge' };

export default async function handler(req) {
  const userId = req.cookies.get('user_id') || 'anonymous';
  
  const { variant_key } = await getVariant('homepage-hero', userId);
  
  return new Response(JSON.stringify({ variant: variant_key }), {
    headers: { 'Content-Type': 'application/json' }
  });
}

async function getVariantWithTimeout(experimentKey, userId, timeout = 3000) {
  const controller = new AbortController();
  const timeoutId = setTimeout(() => controller.abort(), timeout);

  try {
    const response = await fetch(url, {
      signal: controller.signal,
      headers: { 'x-testly-auth': apiKey }
    });
    return await response.json();
  } catch (error) {
    console.error('Timeout ou erro:', error);
    return { variant_key: null }; // Fallback
  } finally {
    clearTimeout(timeoutId);
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}