IASER API Documentation

Complete API reference for IASER Strategic Warfare System integration

API Overview

IASER provides comprehensive RESTful and WebSocket APIs for strategic warfare integration:

-- Basic DCS Integration local http = require("socket.http") local json = require("json") -- Send strategic command local response = http.request("http://localhost:8080/api/v1/strategic/execute", json.encode({ command = "ANALYZE_SITUATION", theater = "CAUCASUS", coalition = "BLUE" }) )

Authentication

All API requests require authentication using API keys:

POST /auth/token

Generate API access token

{ "username": "iaser_operator", "password": "strategic_access_2024", "permissions": ["strategic_ai", "economic_warfare", "frontline_mgmt"] }
Response:
{ "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expires_in": 3600, "permissions": ["strategic_ai", "economic_warfare", "frontline_mgmt"], "operator_level": "TACTICAL_COMMANDER" }

Include token in headers:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Strategic AI API

Control strategic decision-making and battlefield analysis:

POST /strategic/analyze

Request strategic situation analysis

Parameter Type Required Description
theater string Yes Theater of operations (CAUCASUS, PERSIAN_GULF, etc.)
coalition string Yes Coalition side (RED, BLUE, NEUTRAL)
focus_areas array No Specific strategic areas to analyze
time_horizon integer No Analysis time horizon in hours (default: 24)
{ "theater": "CAUCASUS", "coalition": "BLUE", "focus_areas": ["AIR_SUPERIORITY", "GROUND_CONTROL", "NAVAL_OPERATIONS"], "time_horizon": 48, "priority_level": "HIGH" }
GET /strategic/decisions

Retrieve current strategic decisions and recommendations

Response:
{ "strategic_assessment": { "overall_situation": "FAVORABLE", "threat_level": 0.6, "opportunity_index": 0.8, "recommended_actions": [ { "action": "EXPAND_AIR_OPERATIONS", "priority": "HIGH", "confidence": 0.9, "estimated_success": 0.85 } ] }, "timestamp": "2024-01-15T14:30:00Z" }
POST /strategic/execute

Execute strategic commands and directives

{ "command": "INITIATE_STRATEGIC_STRIKE", "target_coordinates": [42.3601, 43.1561], "strike_package": "HEAVY_BOMBER", "timing": "IMMEDIATE", "authorization_level": "STRATEGIC_COMMAND" }

Economic Warfare API

Monitor and manipulate economic systems and resource flows:

GET /economic/status

Get current economic warfare status

Response:
{ "economic_indicators": { "gdp_impact": -0.15, "supply_chain_disruption": 0.35, "resource_availability": { "oil": 0.7, "steel": 0.4, "electronics": 0.6 }, "strategic_reserves": { "fuel": 85, "ammunition": 70, "medical": 90 } }, "warfare_effectiveness": 0.78 }
POST /economic/target

Target specific economic infrastructure

{ "target_type": "SUPPLY_DEPOT", "coordinates": [41.7151, 44.8271], "impact_level": "CRITICAL", "secondary_effects": ["LOGISTICS_DISRUPTION", "MORALE_IMPACT"], "execution_timeframe": "WITHIN_6_HOURS" }
GET /economic/resources

Monitor resource flows and strategic materials

Parameter Type Description
region string Geographic region to monitor
resource_type string Specific resource (fuel, ammunition, etc.)
time_range string Time period for analysis (1h, 6h, 24h)

Frontline Management API

Control dynamic frontline evolution and territorial control:

GET /frontline/status

Get current frontline positions and control zones

Response:
{ "frontline_segments": [ { "id": "SEGMENT_001", "start_coord": [42.1234, 43.5678], "end_coord": [42.2345, 43.6789], "control_strength": 0.75, "fluidity": 0.3, "recent_activity": "BLUE_ADVANCE" } ], "control_zones": { "blue_territory": 0.65, "red_territory": 0.30, "contested": 0.05 } }
POST /frontline/update

Update frontline positions based on tactical events

{ "event_type": "TERRITORIAL_GAIN", "coalition": "BLUE", "affected_area": { "center": [42.3456, 43.7890], "radius": 5000 }, "strength_change": 0.2, "confidence": 0.85 }
POST /frontline/predict

Predict frontline evolution based on current trends

{ "prediction_horizon": 72, "scenario_factors": ["CURRENT_MOMENTUM", "SUPPLY_LINES", "REINFORCEMENTS"], "confidence_threshold": 0.7 }

Intelligence Operations API

Gather and analyze battlefield intelligence:

POST /intelligence/collect

Initiate intelligence collection operation

{ "collection_type": "SIGINT", "target_area": { "center": [42.5000, 44.0000], "radius": 10000 }, "priority": "HIGH", "duration": 3600, "assets": ["AWACS", "GROUND_STATIONS"] }
GET /intelligence/reports

Retrieve processed intelligence reports

Response:
{ "reports": [ { "id": "INTEL_001", "classification": "SECRET", "source_reliability": 0.9, "information_credibility": 0.8, "summary": "Enemy force concentration detected", "details": { "unit_count": 15, "unit_types": ["TANK", "APC", "ARTILLERY"], "estimated_strength": "BATTALION_LEVEL" }, "timestamp": "2024-01-15T15:30:00Z" } ] }

System Status API

Monitor IASER system health and performance:

GET /system/health

Get overall system health status

Response:
{ "system_status": "OPERATIONAL", "components": { "strategic_ai": "ACTIVE", "economic_warfare": "ACTIVE", "frontline_management": "ACTIVE", "intelligence_ops": "ACTIVE", "tcp_server": "LISTENING" }, "performance_metrics": { "cpu_usage": 25.6, "memory_usage": 45.2, "network_latency": 12, "api_response_time": 150 }, "uptime": 86400 }

WebSocket API

Real-time strategic updates and notifications:

-- WebSocket connection for real-time updates local ws = require("websocket") local client = ws.client() client:connect("ws://localhost:8080/ws", "iaser-protocol") client:on("message", function(message) local data = json.decode(message) if data.type == "STRATEGIC_UPDATE" then env.info("Strategic situation changed: " .. data.summary) end end) -- Subscribe to specific event types client:send(json.encode({ action = "SUBSCRIBE", events = ["STRATEGIC_DECISIONS", "FRONTLINE_CHANGES", "INTEL_UPDATES"] }))

WebSocket Message Types:

Complete Integration Examples

DCS Mission Integration

-- Complete IASER integration for DCS missions local IASER = {} IASER.host = "127.0.0.1" IASER.port = 8080 IASER.token = nil -- Initialize IASER connection function IASER.initialize() local socket = require("socket") local json = require("json") IASER.client = socket.tcp() local result, err = IASER.client:connect(IASER.host, IASER.port) if result then -- Authenticate and get token local auth_request = json.encode({ username = "dcs_mission", password = "strategic_access", permissions = ["strategic_ai", "frontline_mgmt"] }) IASER.client:send("POST /api/v1/auth/token HTTP/1.1\r\n") IASER.client:send("Content-Type: application/json\r\n") IASER.client:send("Content-Length: " .. #auth_request .. "\r\n\r\n") IASER.client:send(auth_request) env.info("✓ IASER Strategic Systems Connected") return true else env.error("IASER Connection Failed: " .. (err or "Unknown")) return false end end -- Strategic situation analysis function IASER.analyzeSituation(coalition, focus_areas) local request = { theater = "CAUCASUS", coalition = coalition, focus_areas = focus_areas or {"AIR_SUPERIORITY", "GROUND_CONTROL"}, time_horizon = 24 } return IASER.sendRequest("/api/v1/strategic/analyze", request) end -- Update frontline based on battle events function IASER.updateFrontline(event_type, coalition, coordinates, strength) local request = { event_type = event_type, coalition = coalition, affected_area = { center = coordinates, radius = 5000 }, strength_change = strength, confidence = 0.8 } return IASER.sendRequest("/api/v1/frontline/update", request) end -- Initialize IASER on mission start if IASER.initialize() then -- Set up periodic strategic analysis timer.scheduleFunction(function() IASER.analyzeSituation("BLUE", {"AIR_SUPERIORITY", "LOGISTICS"}) end, nil, timer.getTime() + 30, 300) -- Every 5 minutes end

Economic Warfare Monitoring

-- Monitor economic warfare impacts function IASER.monitorEconomicWarfare() local status = IASER.sendRequest("/api/v1/economic/status") if status and status.economic_indicators then local indicators = status.economic_indicators -- Check critical resource levels for resource, level in pairs(indicators.resource_availability) do if level < 0.3 then env.info("⚠️ Critical resource shortage: " .. resource .. " at " .. (level * 100) .. "%") end end -- Analyze strategic reserves for reserve, percentage in pairs(indicators.strategic_reserves) do if percentage < 20 then env.info("🔴 Strategic reserve critical: " .. reserve .. " at " .. percentage .. "%") end end end end
Quick Start Guide Download IASER