================================================================================
                         eufo.ai API DOCUMENTATION
                      Complete Guide & User Reference
================================================================================

TABLE OF CONTENTS:
1. Getting Started
2. API Authentication
3. Chat API Reference
4. Code Examples
5. Error Handling
6. Billing & Usage
7. FAQ

================================================================================
1. GETTING STARTED
================================================================================

What is eufo.ai?
eufo.ai is an AI chatbot SaaS platform that provides:
- Web-based chat interface
- REST API for programmatic access  
- API key management
- Usage tracking and billing
- Admin dashboard

Quick Setup:
1. Visit https://eufo.ai
2. Click "Get Started" to register
3. Login to access dashboard
4. Start chatting or create API keys

================================================================================
2. API AUTHENTICATION
================================================================================

Creating an API Key:
1. Login to https://eufo.ai
2. Go to Dashboard → API Keys
3. Click "Create API Key"
4. Fill in the form:
   - Key Name: Descriptive name
   - Bot Name: Custom bot name
   - System Prompt: Instructions for AI behavior
5. Copy and save your key (starts with sk-)

Using the API Key:
Include the API key in the X-API-Key header for all requests:
X-API-Key: sk-xxxxxxxxxxxxxxxxxxxxx

================================================================================
3. CHAT API REFERENCE
================================================================================

Endpoint:
POST https://eufo.ai/api/v1/chat

Request Format:
{
  "message": "Your message here",
  "history": []
}

Response Format:
{
  "reply": "The AI's response",
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150
  }
}

Status Codes:
- 200 OK: Success
- 401 Unauthorized: Invalid API key
- 429 Too Many Requests: Quota exceeded
- 500 Internal Server Error: Server error

================================================================================
4. CODE EXAMPLES
================================================================================

JAVASCRIPT/NODE.JS:
---
const axios = require('axios');
const API_KEY = 'sk-xxxxxxxxxxxxx';

async function chat(message) {
  const response = await axios.post('https://eufo.ai/api/v1/chat', {
    message: message,
    history: []
  }, {
    headers: { 'X-API-Key': API_KEY }
  });
  console.log(response.data.reply);
}

chat('Hello!');
---

PYTHON:
---
import requests

API_KEY = 'sk-xxxxxxxxxxxxx'

def chat(message):
    response = requests.post(
        'https://eufo.ai/api/v1/chat',
        json={'message': message, 'history': []},
        headers={'X-API-Key': API_KEY}
    )
    print(response.json()['reply'])

chat('Hello!')
---

CURL:
---
curl -X POST https://eufo.ai/api/v1/chat   -H "X-API-Key: sk-xxxxxxxxxxxxx"   -H "Content-Type: application/json"   -d '{"message":"Hello!","history":[]}'
---

================================================================================
5. ERROR HANDLING
================================================================================

401 Unauthorized - Invalid API Key
Error: {"detail": "Invalid API key"}
Solution: Verify your API key is correct

429 Too Many Requests - Quota Exceeded
Error: {"detail": "Token quota exceeded"}
Solution: Upgrade your plan or wait for monthly reset

500 Internal Server Error
Error: {"error": "Request failed"}
Solution: Try again in a few moments

================================================================================
6. BILLING & USAGE
================================================================================

Subscription Plans:
Plan        | Monthly Tokens | Price
Free        | 10,000         | Free
Pro         | 100,000        | $29/month
Enterprise  | Unlimited      | Contact sales

View Your Usage:
1. Login to https://eufo.ai
2. Go to Dashboard → Subscription
3. See current usage and plan

================================================================================
7. FAQ
================================================================================

Q: How do I reset my API key?
A: Create a new one and delete the old one.

Q: How long is my API key valid?
A: API keys don't expire unless revoked.

Q: Can I use one key for multiple apps?
A: Yes, but recommend separate keys for security.

Q: How many API keys can I create?
A: Unlimited keys per account.

Q: What if I exceed my token quota?
A: API returns 429. Upgrade your plan or wait for monthly reset.

Q: How do I contact support?
A: Email support@eufo.ai

================================================================================
CONTACT & SUPPORT
================================================================================

Website: https://eufo.ai
Email: support@eufo.ai  
Documentation: https://eufo.ai/help

================================================================================
Version: 1.0
Last Updated: July 2026
================================================================================