🛠️ Developer Documentation

# Install Fit1.ai SDK
npm install @fit1ai/sdk

# Initialize with your API key
export FIT1_API_KEY="your_api_key_here"

# Make your first API call
curl -X GET https://api.fit1.ai/v1/campaigns \
  -H "Authorization: Bearer $FIT1_API_KEY"

// Create a new campaign
const campaign = await fit1.campaigns.create({
  name: "Summer Fitness Challenge",
  platforms: ["google", "facebook", "instagram"],
  budget: {
    daily: 500,
    currency: "USD"
  },
  targeting: {
    interests: ["fitness", "health", "wellness"],
    demographics: {
      age: { min: 18, max: 45 },
      gender: "all"
    }
  },
  aiOptimization: {
    enabled: true,
    goals: ["conversions", "engagement"],
    bidStrategy: "auto"
  }
});

console.log(`Campaign launched: ${campaign.id}`);

# Python SDK Example
from fit1ai import Client

# Initialize client
client = Client(api_key="your_api_key")

# Get AI optimization insights
insights = client.ai.get_insights(
    campaign_id="camp_123",
    metrics=["ctr", "conversions", "roas"],
    period="last_7_days"
)

# Process optimization recommendations
for recommendation in insights.recommendations:
    print(f"Action: {recommendation.action}")
    print(f"Impact: {recommendation.expected_impact}")
    
    # Auto-apply high-confidence optimizations
    if recommendation.confidence > 0.9:
        client.campaigns.apply_optimization(
            campaign_id="camp_123",
            optimization=recommendation
        )

// Webhook endpoint example
app.post('/webhooks/fit1', (req, res) => {
  const signature = req.headers['x-fit1-signature'];
  
  // Verify webhook signature
  if (!verifyWebhookSignature(req.body, signature)) {
    return res.status(401).send('Invalid signature');
  }
  
  const event = req.body;
  
  switch(event.type) {
    case 'campaign.optimized':
      console.log(`Campaign ${event.data.campaign_id} optimized`);
      console.log(`New ROAS: ${event.data.metrics.roas}`);
      break;
      
    case 'mining.tokens_earned':
      console.log(`User earned ${event.data.amount} tokens`);
      updateUserBalance(event.data.user_id, event.data.amount);
      break;
      
    case 'ai.anomaly_detected':
      console.log(`Anomaly detected: ${event.data.description}`);
      notifyMarketingTeam(event.data);
      break;
  }
  
  res.status(200).send('OK');
});