import Layout from "@/components/Layout"; import SEO from "@/components/SEO"; import { Breadcrumbs } from "@/components/dev-platform/Breadcrumbs"; import { ThreeColumnLayout } from "@/components/dev-platform/layouts/ThreeColumnLayout"; import { ApiEndpointCard } from "@/components/dev-platform/ui/ApiEndpointCard"; import { CodeTabs } from "@/components/dev-platform/CodeTabs"; import { Card } from "@/components/ui/card"; import { Badge } from "@/components/ui/badge"; import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"; import { Key, Activity, User, Shield, Database } from "lucide-react"; const navigationSections = [ { id: "authentication", title: "Authentication", icon: Key }, { id: "api-keys", title: "API Keys", icon: Key }, { id: "users", title: "Users", icon: User }, { id: "content", title: "Content", icon: Database }, { id: "rate-limits", title: "Rate Limits", icon: Shield }, ]; export default function ApiReference() { const sidebarContent = (
{navigationSections.map((section) => ( {section.title} ))}
); const asideContent = (

API Authentication

All requests require authentication via API key in the Authorization header.

Authorization: Bearer aethex_sk_...

Base URL

https://aethex.dev/api

Rate Limits

); return (
{/* Introduction */}

Introduction

The AeThex API allows you to programmatically interact with the platform. Access user data, create content, manage community features, and more.

RESTful API

Simple HTTP requests with JSON responses

Secure

API key authentication with rate limiting

Comprehensive

Access all platform features programmatically

{/* Authentication */}

Authentication

Authenticate your requests using an API key in the Authorization header.

{/* API Keys Endpoints */}

API Keys

Manage your API keys programmatically.

{/* Users Endpoints */}

Users

Access user profiles and data.

{/* Content Endpoints */}

Content

Create and manage community posts and content.

{/* Rate Limits */}

Rate Limits

API requests are rate limited to ensure fair usage and platform stability.

Free Plan

  • Per Minute 60 requests
  • Per Day 10,000 requests
  • Keys 3 API keys max

Pro Plan

  • Per Minute 300 requests
  • Per Day 100,000 requests
  • Keys 10 API keys max

Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1704672000
setTimeout(resolve, retryAfter * 1000)); return makeRequest(url); } return response.json(); }`, }, { language: "python", label: "Python", code: `import requests import time from datetime import datetime def make_request(url): response = requests.get( url, headers={'Authorization': 'Bearer aethex_sk_your_api_key_here'} ) # Check rate limit headers limit = response.headers.get('X-RateLimit-Limit') remaining = response.headers.get('X-RateLimit-Remaining') reset = response.headers.get('X-RateLimit-Reset') print(f'Rate limit: {remaining}/{limit} remaining') print(f'Resets at: {datetime.fromtimestamp(int(reset))}') if response.status_code == 429: retry_after = int(response.headers.get('Retry-After', 60)) print(f'Rate limited. Retry after {retry_after}s') time.sleep(retry_after) return make_request(url) return response.json()`, }, ]} />
{/* Error Responses */}

Error Responses

The API uses conventional HTTP response codes and returns JSON error objects.

400

Bad Request

The request was invalid or missing required parameters.

401

Unauthorized

Invalid or missing API key.

403

Forbidden

Valid API key but insufficient permissions for this operation.

404

Not Found

The requested resource does not exist.

429

Too Many Requests

Rate limit exceeded. Check Retry-After header.

500

Internal Server Error

Something went wrong on our end. Try again or contact support.

Error Response Format

); }