Aevum Encyclopedia API Reference

Introduction #

The Aevum Encyclopedia API provides programmatic access to our entire knowledge graph, article repository, and real-time verification engine. All requests must be made over HTTPS, and API keys are required for authentication.

ℹ️ Quick Start

Sign up for a free developer account to receive your API key. You can make up to 100 requests per day without upgrading.

Authentication #

Authenticate your requests by including your API key in the `X-API-Key` header. Alternatively, use Bearer tokens for OAuth2 flows.

Header

X-API-Key: your_live_api_key_here

⚠️ Security Notice

Never expose your API keys in client-side code or public repositories. Use environment variables or a secure backend proxy for web applications.

Base URL & Versions #

All API endpoints are versioned in the URL path. The current stable version is v1.

Production

https://api.aevum-encyclopedia.com/v1

Sandbox / Testing

https://api-sandbox.aevum-encyclopedia.com/v1

Articles #

Retrieve and manage encyclopedia articles. Supports full-text content, structured metadata, and revision history.

GET /articles/{id}

Returns the full article object for the specified ID.

Parameters

Parameter	Type	Description
`id` Required	`string`	Unique article identifier (UUID v4)
`fields` Optional	`string`	Comma-separated list of fields to return (default: all)
`include_media` Optional	`boolean`	Include attached images and diagrams (default: false)

cURL

curl -X GET "https://api.aevum-encyclopedia.com/v1/articles/a1b2c3d4-e5f6-7890-1234-567890abcdef" \
  -H "X-API-Key: your_api_key" \
  -H "Accept: application/json"

Python

import requests

resp = requests.get(
  "https://api.aevum-encyclopedia.com/v1/articles/a1b2c3d4...",
  headers={"X-API-Key": "your_api_key"}
)
print(resp.json())

JavaScript

const res = await fetch("https://api.aevum-encyclopedia.com/v1/articles/a1b2c3d4...", {
  headers: { "X-API-Key": "your_api_key" }
});
const data = await res.json();

Response Example

JSON

{
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "title": "Quantum Entanglement",
  "slug": "quantum-entanglement",
  "language": "en",
  "content": "Quantum entanglement is a physical phenomenon that occurs when...",
  "metadata": {
    "category": "Physics",
    "last_updated": "2025-04-12T14:32:00Z",
    "version": 42,
    "read_time_minutes": 8
  },
  "verification": {
    "status": "peer_reviewed",
    "reviewers": ["dr_kim", "prof_morrison"]
  }
}

Rate Limits #

API access is tiered based on your subscription plan. Limits are enforced per API key and reset hourly.

Plan	Requests / Hour	Requests / Day	Concurrency
Free	20	100	2
Pro	1,000	10,000	10
Enterprise	50,000+	Unlimited	Custom

✅ Retry Strategy

When you receive a 429 Too Many Requests, check the Retry-After header and implement exponential backoff.

Error Handling #

Aevum uses conventional HTTP response codes to indicate success or failure of requests.

200

OK - The request succeeded.

201

Created - Resource successfully created.

400

Bad Request - Invalid parameters or malformed JSON.

401

Unauthorized - Invalid or missing API key.

404

Not Found - Resource does not exist.

429

Rate Limited - Too many requests.

Error Response Format

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your hourly request quota.",
    "details": "Reset at 2025-04-12T15:00:00Z"
  }
}