API Reference

// Use version in URL path
https://api.initrepo.com/v1/projects

const headers = {
  'Authorization': 'Bearer ir_live_your_api_key',
  'Accept': 'application/vnd.initrepo.v1+json'
};

const headers = {
  'Authorization': 'Bearer ir_live_your_api_key',
  'API-Version': 'v1.0'
};

// Response headers
API-Version: v1.0
API-Supported-Versions: v1.0
API-Latest-Version: v1.0
X-Request-ID: req_1234567890

const headers = {
  'Authorization': 'Bearer ir_live_your_api_key_here',
  'Content-Type': 'application/json',
  'API-Version': 'v1.0'
};

// Create a new project for AI-powered generation
const response = await fetch('https://api.initrepo.com/v1/projects', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ir_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    projectIdea: 'Build a modern e-commerce platform with AI recommendations',
    projectType: 'web',
    features: [
      {
        name: 'Product Catalog',
        description: 'Display products with search and filtering capabilities'
      }
    ],
    integrations: ['stripe', 'sendgrid'],
    format: 'full',
    webhookUrl: 'https://your-app.com/webhooks/initrepo'
  })
});

// Check project generation status
const response = await fetch('https://api.initrepo.com/v1/projects/{projectId}', {
  headers: {
    'Authorization': 'Bearer ir_live_your_api_key'
  }
});

// Response headers
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699123456  // Unix timestamp

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 60 seconds.",
    "request_id": "req_1234567890",
    "details": {
      "retry_after": 60,
      "limit": 100,
      "window": "1 minute"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "message": "Invalid API key provided",
    "request_id": "req_1234567890",
    "documentation": "https://docs.initrepo.com/api/authentication",
    "details": {
      "field": "authorization_header",
      "issue": "malformed_key"
    }
  }
}

if (!response.ok) {
  const error = await response.json();
  console.error(`API Error: ${error.error.code} - ${error.error.message}`);
}

const errorData = await response.json();
console.log(`Request ID for support: ${errorData.error.request_id}`);

async function makeAPIRequest(url, options, retries = 3) {
  try {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      // Rate limited - check retry after header
      const retryAfter = response.headers.get('retry-after') || 60;
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      return makeAPIRequest(url, options, retries - 1);
    }
    
    return response;
  } catch (error) {
    if (retries > 0) {
      await new Promise(resolve => setTimeout(resolve, 1000));
      return makeAPIRequest(url, options, retries - 1);
    }
    throw error;
  }
}

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "message": "Invalid API key format",
    "details": {
      "expected_format": "ir_live_ or ir_test_ followed by 32 characters"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Required field missing",
    "details": {
      "missing_fields": ["projectIdea"],
      "invalid_fields": {
        "projectType": "Must be one of: web, mobile, api, desktop"
      }
    }
  }
}