Articles API

Access, search, and manage encyclopedia articles programmatically. The Articles API provides RESTful endpoints for retrieving structured knowledge, metadata, and revision history.

ℹ️

Base URL: https://api.aevumencyclopedia.com/v2

All endpoints require authentication via API key. See the Authentication section for details.

Authentication

Authenticate your requests by including your API key in the Authorization header. Keys can be generated from the Developer Dashboard.

cURL

curl -X GET "https://api.aevumencyclopedia.com/v2/articles/quantum-mechanics" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

⚠️

Security Notice: Never expose your API key in client-side code. Use environment variables or a backend proxy to handle sensitive requests.

Core Endpoints

Method	Endpoint	Description
GET	`/articles/{id}`	Retrieve a specific article by ID or slug
GET	`/articles`	List articles with filtering, sorting, and pagination
POST	`/articles`	Submit a new article draft (contributors only)
PUT	`/articles/{id}/revisions`	Update an existing article with peer review required

Response Schema

Successful requests return a 200 OK status with a JSON payload matching the following structure:

JSON

{
  "id": "art_8f3k29d1",
  "slug": "quantum-mechanics",
  "title": "Quantum Mechanics",
  "summary": "Quantum mechanics is a fundamental theory in physics that provides a description of the physical properties of nature at the scale of atoms and subatomic particles.",
  "content": "...",
  "metadata": {
    "word_count": 4820,
    "language": "en",
    "category": "physics",
    "last_updated": "2025-01-15T14:30:00Z",
    "verified": true,
    "contributors": 14
  },
  "links": {
    "self": "/v2/articles/quantum-mechanics",
    "history": "/v2/articles/quantum-mechanics/revisions",
    "related": "/v2/articles?related=quantum-mechanics"
  }
}

Rate Limits & Throttling

The API enforces rate limits to ensure fair usage and system stability. Limits are applied per API key and reset on a rolling 60-second window.

Free Tier: 100 requests/minute
Pro Tier: 1,000 requests/minute
Enterprise: Custom limits (contact sales)

Rate limit headers are included in every response:

HTTP Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1704567890
Retry-After: 42  // Only present when limit is exceeded

Error Handling

The API uses conventional HTTP status codes to indicate success or failure. Codes in the 2xx range indicate success, 4xx indicate client errors, and 5xx indicate server errors.

Error Response

{
  "error": {
    "code": 404,
    "message": "Article not found",
    "details": "The requested slug 'invalid-topic' does not exist in our knowledge base.",
    "documentation_url": "https://docs.aevumencyclopedia.com/errors#404"
  }
}

💡

Pro Tip: Use the X-Request-ID header in your requests to track transactions across logs and support tickets.