🔌 API Reference

{ "success": true, "data": { ... }, "message": "Operation successful" }

{ "success": false, "error": "Error message", "code": "ERROR_CODE", "details": { ... } }

// Generate AI Proposal async function generateProposal(description) { const response = await fetch('https://your-worker.workers.dev/api/generate-ai', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ description, currency: 'USD' }) }); const result = await response.json(); if (result.success) { return result.data; } else { throw new Error(result.error); } } // Generate PDF async function generatePDF(proposalData) { const response = await fetch('https://your-worker.workers.dev/api/generate-pdf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(proposalData) }); const result = await response.json(); if (result.success) { // Create download link const link = document.createElement('a'); link.href = result.data.pdfUrl; link.download = result.data.fileName; link.click(); } else { throw new Error(result.error); } } // Usage const proposal = await generateProposal('Build an e-commerce website...'); await generatePDF(proposal);

import requests import json class ProposalForge: def __init__(self, base_url): self.base_url = base_url def generate_ai_proposal(self, description, currency='USD'): """Generate proposal using AI""" url = f"{self.base_url}/api/generate-ai" payload = { "description": description, "currency": currency } response = requests.post(url, json=payload) result = response.json() if result['success']: return result['data'] else: raise Exception(result['error']) def generate_pdf(self, proposal_data): """Generate PDF from proposal data""" url = f"{self.base_url}/api/generate-pdf" response = requests.post(url, json=proposal_data) result = response.json() if result['success']: # Save PDF to file pdf_data = result['data']['pdfUrl'].split(',')[1] with open(result['data']['fileName'], 'wb') as f: f.write(base64.b64decode(pdf_data)) return result['data']['fileName'] else: raise Exception(result['error']) # Usage client = ProposalForge('https://your-worker.workers.dev') proposal = client.generate_ai_proposal('Build an e-commerce website...') pdf_file = client.generate_pdf(proposal) print(f"PDF saved to: {pdf_file}")

<?php class ProposalForge { private $baseUrl; public function __construct($baseUrl) { $this->baseUrl = $baseUrl; } public function generateAIProposal($description, $currency = 'USD') { $url = $this->baseUrl . '/api/generate-ai'; $data = [ 'description' => $description, 'currency' => $currency ]; $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); if ($result['success']) { return $result['data']; } else { throw new Exception($result['error']); } } public function generatePDF($proposalData) { $url = $this->baseUrl . '/api/generate-pdf'; $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($proposalData)); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); if ($result['success']) { return $result['data']; } else { throw new Exception($result['error']); } } } // Usage $client = new ProposalForge('https://your-worker.workers.dev'); $proposal = $client->generateAIProposal('Build an e-commerce website...'); $pdf = $client->generatePDF($proposal); echo "PDF generated: " . $pdf['fileName']; ?>

try { const proposal = await generateProposal(description); const pdf = await generatePDF(proposal); } catch (error) { if (error.code === 'RATE_LIMIT_EXCEEDED') { // Wait and retry await new Promise(resolve => setTimeout(resolve, 60000)); return generateProposal(description); } else if (error.code === 'AI_SERVICE_ERROR') { // Fallback to manual creation showManualForm(); } else { // Show error to user showError(error.message); } }

async function retryWithBackoff(fn, maxRetries = 3) { for (let i = 0; i < maxRetries; i++) { try { return await fn(); } catch (error) { if (error.code === 'RATE_LIMIT_EXCEEDED' && i < maxRetries - 1) { const delay = Math.pow(2, i) * 1000; await new Promise(resolve => setTimeout(resolve, delay)); } else { throw error; } } } }

let currencyCache = null; let cacheExpiry = null; async function getCurrencies() { const now = Date.now(); if (currencyCache && cacheExpiry && now < cacheExpiry) { return currencyCache; } const response = await fetch('/api/currencies'); const result = await response.json(); currencyCache = result.data; cacheExpiry = now + 3600000; // 1 hour return currencyCache; }

function validateProposal(data) { const errors = []; if (!data.clientName || data.clientName.length < 2) { errors.push('Client name must be at least 2 characters'); } if (!data.projectOverview || data.projectOverview.length < 20) { errors.push('Project overview must be at least 20 characters'); } if (!data.phases || data.phases.length === 0) { errors.push('At least one phase is required'); } data.phases?.forEach((phase, index) => { if (!phase.name) errors.push(`Phase ${index + 1}: Name is required`); if (!phase.price || phase.price <= 0) { errors.push(`Phase ${index + 1}: Price must be positive`); } }); return errors; }