API Documentation

Welcome to the Wildoria API! Access game data programmatically to build amazing tools and integrations.

Base URL

https://api.wildoria.com/v1

Authentication

All API requests require an API key. Include your key in the request header:

Authorization: Bearer YOUR_API_TOKEN

Request API Access

To obtain an API token, send an email to [email protected] with:

• Your name or organization
• Intended use case
• Expected request volume

We'll review your request and respond within 48 hours.

Rate Limits

Plan	Requests/minute	Requests/day
Free	60	10,000
Developer	300	100,000
Enterprise	Unlimited	Unlimited

---

Endpoints

Items

Get All Items

GET /items

Query Parameters:

Parameter	Type	Description
category	string	Filter by category (weapon, armor, consumable, etc.)
rarity	string	Filter by rarity (common, uncommon, rare, epic, legendary)
limit	number	Number of results (default: 50, max: 200)
offset	number	Pagination offset

Response:

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "item_001",
        "name": "Iron Sword",
        "category": "weapon",
        "rarity": "common",
        "stats": {
          "attack": 15,
          "durability": 100
        },
        "icon": "https://api.wildoria.com/assets/items/iron_sword.png"
      }
    ],
    "total": 1250,
    "limit": 50,
    "offset": 0
  }
}

Get Item by ID

GET /items/{item_id}

Response:

{
  "success": true,
  "data": {
    "id": "item_001",
    "name": "Iron Sword",
    "description": "A basic iron sword for beginners.",
    "category": "weapon",
    "subcategory": "sword",
    "rarity": "common",
    "level_required": 1,
    "stats": {
      "attack": 15,
      "attack_speed": 1.2,
      "durability": 100
    },
    "crafting": {
      "craftable": true,
      "recipe_id": "recipe_iron_sword",
      "materials": [
        { "item_id": "iron_ore", "quantity": 5 },
        { "item_id": "wood", "quantity": 2 }
      ]
    },
    "icon": "https://api.wildoria.com/assets/items/iron_sword.png",
    "model_3d": "https://api.wildoria.com/assets/models/iron_sword.glb"
  }
}

---

Categories

Get All Categories

GET /categories

Response:

{
  "success": true,
  "data": {
    "categories": [
      {
        "id": "weapon",
        "name": "Weapons",
        "icon": "⚔️",
        "subcategories": ["sword", "axe", "bow", "staff", "dagger"]
      },
      {
        "id": "armor",
        "name": "Armor",
        "icon": "🛡️",
        "subcategories": ["helmet", "chest", "legs", "boots", "gloves"]
      },
      {
        "id": "consumable",
        "name": "Consumables",
        "icon": "🧪",
        "subcategories": ["potion", "food", "scroll"]
      }
    ]
  }
}

Get Category Details

GET /categories/{category_id}

---

Characters

Get Character Info

GET /characters/{character_id}

Response:

{
  "success": true,
  "data": {
    "id": "char_abc123",
    "name": "WildHunter",
    "level": 45,
    "class": "ranger",
    "guild": "Dragon Slayers",
    "stats": {
      "health": 1250,
      "mana": 480,
      "attack": 320,
      "defense": 180
    },
    "equipment": {
      "weapon": "item_legendary_bow",
      "armor": "item_ranger_set"
    },
    "achievements_count": 127,
    "playtime_hours": 342
  }
}

---

Skills

Get All Skills

GET /skills

Get Skill by ID

GET /skills/{skill_id}

---

Crafting

Get Recipe

GET /crafting/recipes/{recipe_id}

Calculate Materials

POST /crafting/calculate

Request Body:

{
  "recipe_id": "recipe_iron_sword",
  "quantity": 5
}

Response:

{
  "success": true,
  "data": {
    "recipe": "Iron Sword",
    "quantity": 5,
    "materials_needed": [
      { "item_id": "iron_ore", "name": "Iron Ore", "quantity": 25 },
      { "item_id": "wood", "name": "Wood", "quantity": 10 }
    ],
    "total_crafting_time": "5m 30s"
  }
}

---

Error Responses

All errors follow this format:

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "The provided API token is invalid or expired.",
    "details": null
  }
}

Error Codes

Code	HTTP Status	Description
INVALID_TOKEN	401	Invalid or expired API token
RATE_LIMIT_EXCEEDED	429	Too many requests
NOT_FOUND	404	Resource not found
INVALID_PARAMETER	400	Invalid query parameter
SERVER_ERROR	500	Internal server error

---

SDKs & Libraries

Coming soon:

• JavaScript/TypeScript SDK
• Python SDK
• C# Unity Package

---

Need Help?

• 📧 Email: [email protected]
• 💬 Discord: Join our server
• 📖 Examples: Check our GitHub repository