API Documentation
Base URL: https://api.golconda.uk/v1
Authentication
All requests require an API key passed via the Authorization header:
Authorization: Bearer YOUR_API_KEY
📄 PDF Generation
POST/v1/pdf/generateConvert a URL or HTML string to PDF.
curl -X POST https://api.golconda.uk/v1/pdf/generate \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "options": {"format": "A4"}}'
// Response: JSON with download URL
{ "id": "pdf_abc123", "url": "https://...", "status": "complete" }
📸 Screenshot
POST/v1/screenshotCapture a screenshot of any URL.
curl -X POST https://api.golconda.uk/v1/screenshot \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"url": "https://example.com", "viewport": "1920x1080", "format": "png"}'
🤖 AI Gateway
POST/v1/ai/chatProxy to OpenAI, Anthropic, or Gemini with automatic caching.
curl -X POST https://api.golconda.uk/v1/ai/chat \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
📱 QR Codes
GET/v1/qr?data=URL&size=300Generate a QR code image.
✉️ Email Validation
GET/v1/email/validate?email=user@example.comValidate an email address.
// Response
{
"email": "user@example.com",
"valid": true,
"mx_records": true,
"disposable": false,
"suggestion": null
}
Rate Limiting
All APIs enforce rate limits based on your plan. Free tier: 10-100 req/day. Paid tiers: monthly quotas. Rate limit headers are included in every response:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1680000000