API & Webhook Documentation

Setting Up Discord Webhook

1. 1.Open your Discord server and go to Server Settings → Integrations → Webhooks
2. 2.Click New Webhook and select the channel for notifications
3. 3.Copy the webhook URL (format: https://discord.com/api/webhooks/...)
4. 4.Paste the URL in the webhook configuration panel and select "Discord" as the type

{
  "username": "Database Intelligence",
  "avatar_url": "https://wolves.land/images/thelandofwolves.png",
  "embeds": [
    {
      "title": "Database Analysis Complete",
      "color": 4359924,
      "timestamp": "2026-01-12T10:30:00.000Z",
      "footer": {
        "text": "The Land of Wolves | Database Intelligence"
      },
      "fields": [
        { "name": "Total Players", "value": "156", "inline": true },
        { "name": "Total Wealth", "value": "$2.45M", "inline": true },
        { "name": "Total Items", "value": "12,456", "inline": true },
        { "name": "Total Assets", "value": "342", "inline": true },
        { "name": "Ledger Money", "value": "$125,000", "inline": true },
        { "name": "Boss Funds", "value": "$45,000", "inline": true }
      ]
    },
    {
      "title": "Top 10 Wealthiest Players",
      "description": "1. **John Doe** (ABC12345)\n   $125,000 | 234 items | Boss",
      "color": 16440068
    },
    {
      "title": "Flagged Players (5 total)",
      "description": "1. **Suspicious Player** (XYZ98765)\n   Score: 85/100 | $500,000\n   Round amounts, Excessive rare items",
      "color": 15352885
    }
  ]
}

API Endpoint Requirements

• •Accepts POST requests with Content-Type: application/json
• •Returns HTTP 2xx status code on success
• •Supports custom headers for authentication (Bearer tokens, API keys)
• •CORS enabled if calling from browser (or use a server-side proxy)

{
  "event": "parse_complete",
  "timestamp": "2026-01-12T10:30:00.000Z",
  "serverName": "The Land of Wolves",
  "source": "wolves-database-intelligence",
  "version": "1.0.0",
  "statistics": {
    "totalPlayers": 156,
    "totalWealth": 2450000,
    "totalItems": 12456,
    "totalAssets": 342,
    "totalLedger": 125000,
    "totalBossFunds": 45000,
    "flaggedCount": 5
  },
  "topPlayers": [
    {
      "citizenId": "ABC12345",
      "name": "John Doe",
      "totalWealth": 125000,
      "cash": 5000,
      "bank": 120000,
      "itemCount": 234,
      "isBoss": true
    }
  ],
  "flaggedPlayers": [
    {
      "citizenId": "XYZ98765",
      "name": "Suspicious Player",
      "suspicionScore": 85,
      "reasons": [
        "Suspiciously round amounts detected",
        "Excessive rare items"
      ],
      "totalWealth": 500000
    }
  ]
}

// JavaScript/Node.js Integration Example
const WEBHOOK_URL = 'https://your-api.example.com/webhook';

async function sendToWebhook(parsedData) {
  const payload = {
    event: 'parse_complete',
    timestamp: new Date().toISOString(),
    serverName: 'My RP Server',
    statistics: {
      totalPlayers: parsedData.players.length,
      totalWealth: parsedData.statistics.totalWealth,
      totalItems: parsedData.statistics.totalItems,
      flaggedCount: parsedData.flaggedPlayers.length
    },
    topPlayers: parsedData.players
      .sort((a, b) => b.totalWealth - a.totalWealth)
      .slice(0, 10)
      .map(p => ({
        citizenId: p.citizenId,
        name: p.fullName,
        totalWealth: p.totalWealth,
        isBoss: p.job?.isBoss || false
      })),
    flaggedPlayers: parsedData.flaggedPlayers.map(p => ({
      citizenId: p.citizenId,
      name: p.fullName,
      suspicionScore: p.suspicionScore,
      reasons: p.flags
    }))
  };

  const response = await fetch(WEBHOOK_URL, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY'
    },
    body: JSON.stringify(payload)
  });

  if (!response.ok) {
    throw new Error(`Webhook failed: ${response.status}`);
  }

  return response.json();
}

-- FiveM/RedM Lua Integration Example
local WEBHOOK_URL = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN'

function SendDatabaseReport(data)
    local embed = {
        {
            ["title"] = "Database Analysis Report",
            ["color"] = 4359924,
            ["timestamp"] = os.date("!%Y-%m-%dT%H:%M:%SZ"),
            ["footer"] = {
                ["text"] = "The Land of Wolves | Database Intelligence"
            },
            ["fields"] = {
                { ["name"] = "Total Players", ["value"] = tostring(data.totalPlayers), ["inline"] = true },
                { ["name"] = "Total Wealth", ["value"] = "$" .. FormatNumber(data.totalWealth), ["inline"] = true },
                { ["name"] = "Flagged Players", ["value"] = tostring(data.flaggedCount), ["inline"] = true }
            }
        }
    }

    PerformHttpRequest(WEBHOOK_URL, function(err, text, headers) end, 'POST', json.encode({
        username = "Database Intelligence",
        avatar_url = "https://wolves.land/images/thelandofwolves.png",
        embeds = embed
    }), { ['Content-Type'] = 'application/json' })
end

function FormatNumber(num)
    if num >= 1000000 then
        return string.format("%.2fM", num / 1000000)
    elseif num >= 1000 then
        return string.format("%.1fK", num / 1000)
    end
    return tostring(num)
end

# Python Integration Example
import requests
import json
from datetime import datetime

WEBHOOK_URL = 'https://your-api.example.com/webhook'
API_KEY = 'YOUR_API_KEY'

def send_database_report(parsed_data: dict) -> dict:
    """Send parsed database results to webhook endpoint."""
    
    payload = {
        "event": "parse_complete",
        "timestamp": datetime.utcnow().isoformat() + "Z",
        "serverName": "My RP Server",
        "source": "wolves-database-intelligence",
        "version": "1.0.0",
        "statistics": {
            "totalPlayers": len(parsed_data.get("players", [])),
            "totalWealth": parsed_data.get("statistics", {}).get("totalWealth", 0),
            "totalItems": parsed_data.get("statistics", {}).get("totalItems", 0),
            "totalAssets": sum(len(p.get("assets", [])) for p in parsed_data.get("players", [])),
            "flaggedCount": len(parsed_data.get("flaggedPlayers", []))
        },
        "topPlayers": [
            {
                "citizenId": p["citizenId"],
                "name": p.get("fullName", "Unknown"),
                "totalWealth": p.get("totalWealth", 0),
                "isBoss": p.get("job", {}).get("isBoss", False)
            }
            for p in sorted(
                parsed_data.get("players", []),
                key=lambda x: x.get("totalWealth", 0),
                reverse=True
            )[:10]
        ],
        "flaggedPlayers": [
            {
                "citizenId": p["citizenId"],
                "name": p.get("fullName", "Unknown"),
                "suspicionScore": p.get("suspicionScore", 0),
                "reasons": p.get("flags", [])
            }
            for p in parsed_data.get("flaggedPlayers", [])
        ]
    }
    
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}"
    }
    
    response = requests.post(WEBHOOK_URL, headers=headers, json=payload)
    response.raise_for_status()
    
    return response.json()