API Documentation

APEX-CORE REST API for physics violation detection

Authentication

All API requests require an API key. Get a free key at /pricing.

Include your API key in requests using one of these methods:

Option 1: X-API-Key Header (Recommended)

curl -H "X-API-Key: apex_your_key_here" https://apex-core-production.up.railway.app/api/health

Option 2: Authorization Bearer Header

curl -H "Authorization: Bearer apex_your_key_here" https://apex-core-production.up.railway.app/api/health

Option 3: Query Parameter

curl "https://apex-core-production.up.railway.app/api/health?api_key=apex_your_key_here"

Rate Limits

When you exceed limits, the API returns 429 Too Many Requests.

Endpoints

{
  "patent_id": "CUSTOM-TEXT",
  "title": "Custom Analysis",
  "verdict": "violation",
  "confidence": 0.95,
  "energy_source": "No legitimate energy source identified",
  "physics_issues": [
    "Violates First Law of Thermodynamics",
    "No identifiable input energy"
  ],
  "explanation": "The claim describes perpetual motion...",
  "violation_patterns": ["PATTERN B - THERMODYNAMICALLY IMPOSSIBLE"]
}

{
  "success": true,
  "api_key": "apex_abc123...",
  "tier": "free",
  "limits": {"daily": 5, "monthly": 25},
  "message": "Save your API key - it won't be shown again!"
}

{
  "tier": "free",
  "email": "user@example.com",
  "limits": {"daily": 5, "monthly": 25},
  "usage": {"remaining_daily": 4, "remaining_monthly": 24}
}

Code Examples

cURL

# Analyze text
curl -X POST https://apex-core-production.up.railway.app/analyze-text \
  -H "Content-Type: application/json" \
  -H "X-API-Key: apex_your_key_here" \
  -d '{"text": "Perpetual motion machine that generates free energy"}'

Python

import requests

API_KEY = "apex_your_key_here"
BASE_URL = "https://apex-core-production.up.railway.app"

def analyze_claim(text):
    response = requests.post(
        f"{BASE_URL}/analyze-text",
        headers={
            "Content-Type": "application/json",
            "X-API-Key": API_KEY
        },
        json={"text": text}
    )
    return response.json()

result = analyze_claim("Perpetual motion machine")
print(f"Verdict: {result['verdict']}")
print(f"Confidence: {result['confidence']}")

JavaScript (fetch)

const API_KEY = 'apex_your_key_here';
const BASE_URL = 'https://apex-core-production.up.railway.app';

async function analyzeClaim(text) {
  const response = await fetch(`${BASE_URL}/analyze-text`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY
    },
    body: JSON.stringify({ text })
  });
  return response.json();
}

// Usage
analyzeClaim('Perpetual motion machine')
  .then(result => console.log(result.verdict));

Error Handling

Error Response Format

{
  "error": "API key required",
  "message": "Include your API key via X-API-Key header...",
  "get_key": "/pricing"
}