Endless Memories API

Getting Started

The Endless Memories API provides read-only access to game data. All requests use HTTP GET and return JSON responses.

Base URL

https://api.endless-memories.net/

Quick Example

curl https://api.endless-memories.net/item/1

{
  "id": 1,
  "name": "Gold",
  "type": { "id": 2, "name": "Currency" },
  ...
}

Authentication

No authentication is required. The API is publicly accessible for all read operations.

Rate Limiting

To ensure fair usage, the API implements rate limiting:

• 60 requests per 60 seconds per IP address

Rate Limit Headers

Endpoints

Response Format

All responses are JSON. HTTP status codes indicate success (200) or failure (4xx/5xx).

Success Response (HTTP 200)

{
  "id": 1,
  "name": "Gold",
  "type": { "id": 2, "name": "Currency" },
  // ... response data at root level
}

Error Response (HTTP 4xx/5xx)

{
  "error": {
    "message": "Human-readable error message",
    "code": "ERROR_CODE"
  }
}

Error Handling

The API uses standard HTTP status codes and returns detailed error information.

HTTP Status Codes

Error Codes

Code Examples

JavaScript (Fetch)

// Get item by ID
const response = await fetch('https://api.endless-memories.net/item/1');

if (response.ok) {
    const item = await response.json();
    console.log(`Item: ${item.name}`);
    console.log(`Type: ${item.type.name}`);
}

// Search for items
const searchResponse = await fetch(
    'https://api.endless-memories.net/item/search?q=sword&type=weapon'
);

if (searchResponse.ok) {
    const data = await searchResponse.json();
    data.items.forEach(item => {
        console.log(`${item.id}: ${item.name}`);
    });
}

Python (Requests)

import requests

# Get item details
response = requests.get('https://api.endless-memories.net/item/1')

if response.ok:
    item = response.json()
    print(f"Item: {item['name']}")
    print(f"Type: {item['type']['name']}")

# Search for items
response = requests.get(
    'https://api.endless-memories.net/item/search',
    params={'q': 'sword', 'type': 'weapon'}
)

if response.ok:
    data = response.json()
    for item in data['items']:
        print(f"{item['id']}: {item['name']}")

cURL

# Get server status
curl https://api.endless-memories.net/status

# Get item by ID
curl https://api.endless-memories.net/item/1

# Search for fire spells
curl "https://api.endless-memories.net/spell/search?type=damage&element=fire"

# Get top players
curl https://api.endless-memories.net/leaderboard/level