{ "openapi": "3.1.0", "info": { "title": "KalkuNet Calc API & Engineering Tools Directory", "version": "1.0.0", "description": "OpenAPI 3.1.0 specification for KalkuNet client-side execution and deep-link query parameter calculators across 47 networking, server, Linux, CCTV, and developer tools.", "contact": { "name": "KalkuNet Engineering Team", "url": "https://kalkunet.com", "email": "admin@kalkunet.com" }, "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" } }, "servers": [ { "url": "https://kalkunet.com", "description": "KalkuNet Production Server" } ], "paths": { "/api/v1/catalog.json": { "get": { "summary": "Retrieve full KalkuNet 47-Calculator JSON Catalog", "operationId": "getCatalog", "responses": { "200": { "description": "Successful response returning metadata and parameter schemas for all 47 tools", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "totalTools": { "type": "integer" }, "tools": { "type": "array" } } } } } } } } }, "/api/v1/calculate/subnet-calculator": { "get": { "summary": "IPv4 Subnet and CIDR Calculator", "description": "Calculate IPv4 network address, broadcast, usable host range, netmask, wildcard, binary mask, and RFC address type (RFC 1918, /31, CGNAT).", "operationId": "calculate_subnet_calculator", "parameters": [ { "name": "ip", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.1.10" }, "description": "IPv4 Address (or IP/CIDR, IP + Netmask, IP + Wildcard)" }, { "name": "prefix", "in": "query", "required": false, "schema": { "type": "number", "default": 24 }, "description": "CIDR Prefix (/0 – /32)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "subnet-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/vlsm-calculator": { "get": { "summary": "IPv4 Subnet Split and VLSM Planner", "description": "Split an IPv4 network into N equal subnets or allocate boundary-aligned VLSM blocks by required host count with CSV and Markdown export.", "operationId": "calculate_vlsm_calculator", "parameters": [ { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.10.0/24" }, "description": "Parent Network (CIDR)" }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "vlsm" }, "description": "Planning Mode" }, { "name": "requirements", "in": "query", "required": false, "schema": { "type": "string", "default": "Staff:100, Voice:50, CCTV:25, WAN:2" }, "description": "Host Requirements per Segment (Mode B VLSM)" }, { "name": "splitCount", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Number of Equal Subnets N (Mode A)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "vlsm-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/ipv6-subnet-calculator": { "get": { "summary": "IPv6 Subnet Calculator and Prefix Planner (/48, /56, /64)", "description": "Expand and compress IPv6 addresses per RFC 5952, calculate network prefix boundaries, /64 SLAAC subnet counts, and child prefix blocks.", "operationId": "calculate_ipv6_subnet_calculator", "parameters": [ { "name": "address", "in": "query", "required": false, "schema": { "type": "string", "default": "2001:db8:abcd:12::1" }, "description": "IPv6 Address or CIDR Prefix" }, { "name": "prefix", "in": "query", "required": false, "schema": { "type": "number", "default": 48 }, "description": "Parent Prefix Length (0–128)" }, { "name": "childPrefix", "in": "query", "required": false, "schema": { "type": "string", "default": "64" }, "description": "Target Child Prefix (Subnet Split)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "ipv6-subnet-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mikrotik-queue-calculator": { "get": { "summary": "MikroTik Bandwidth Calculator (Simple Queue, Burst, PCQ, FQ-CoDel)", "description": "Calculate Limit-At (CIR), Max-Limit (MIR), Burst, PCQ, and FQ-CoDel for RouterOS v7 with automated configuration script generation.", "operationId": "calculate_mikrotik_queue_calculator", "parameters": [ { "name": "target", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.0/24" }, "description": "Target Network (CIDR) or Interface" }, { "name": "down", "in": "query", "required": false, "schema": { "type": "number", "default": 100 }, "description": "ISP Download Bandwidth (Mbps)" }, { "name": "up", "in": "query", "required": false, "schema": { "type": "number", "default": 40 }, "description": "ISP Upload Bandwidth (Mbps)" }, { "name": "users", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Total Number of Clients / Devices" }, { "name": "concurrency", "in": "query", "required": false, "schema": { "type": "number", "default": 50 }, "description": "Active Client Concurrency Ratio (%)" }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "simple" }, "description": "Queue Mode (Strategy)" }, { "name": "burstPct", "in": "query", "required": false, "schema": { "type": "number", "default": 150 }, "description": "Burst Multiplier (% of Max-Limit)" }, { "name": "thresholdPct", "in": "query", "required": false, "schema": { "type": "number", "default": 75 }, "description": "Burst Threshold (% of Max-Limit)" }, { "name": "burstTime", "in": "query", "required": false, "schema": { "type": "number", "default": 8 }, "description": "Burst-Time Window (Seconds)" }, { "name": "headroom", "in": "query", "required": false, "schema": { "type": "number", "default": 95 }, "description": "ISP Shaping Headroom (%)" }, { "name": "startHost", "in": "query", "required": false, "schema": { "type": "number", "default": 2 }, "description": "Start Host Offset for Client Queues" }, { "name": "parentName", "in": "query", "required": false, "schema": { "type": "string", "default": "ST-TOTAL" }, "description": "Parent Queue Name" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mikrotik-queue-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mikrotik-pcc-calculator": { "get": { "summary": "MikroTik Multi-WAN PCC Load Balance Calculator", "description": "Multi-WAN (2–5 ISP) proportional PCC load balancing and recursive failover configuration script generator for RouterOS v7.", "operationId": "calculate_mikrotik_pcc_calculator", "parameters": [ { "name": "ispCount", "in": "query", "required": false, "schema": { "type": "string", "default": "2" }, "description": "Number of ISP Providers" }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "pcc" }, "description": "Operation Mode" }, { "name": "classifier", "in": "query", "required": false, "schema": { "type": "string", "default": "both-addresses-and-ports" }, "description": "PCC Classifier" }, { "name": "lanIface", "in": "query", "required": false, "schema": { "type": "string", "default": "bridge-lan" }, "description": "LAN Bridge Interface" }, { "name": "lanCidr", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.0/24" }, "description": "LAN Subnet (CIDR)" }, { "name": "isp1Bw", "in": "query", "required": false, "schema": { "type": "number", "default": 100 }, "description": "ISP 1 Bandwidth (Mbps)" }, { "name": "isp1Gw", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.1.1" }, "description": "ISP 1 Gateway IP" }, { "name": "isp1Iface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether1-ISP1" }, "description": "ISP 1 Interface" }, { "name": "isp2Bw", "in": "query", "required": false, "schema": { "type": "number", "default": 50 }, "description": "ISP 2 Bandwidth (Mbps)" }, { "name": "isp2Gw", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.2.1" }, "description": "ISP 2 Gateway IP" }, { "name": "isp2Iface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether2-ISP2" }, "description": "ISP 2 Interface" }, { "name": "isp3Bw", "in": "query", "required": false, "schema": { "type": "number", "default": 50 }, "description": "ISP 3 Bandwidth (Mbps)" }, { "name": "isp3Gw", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.3.1" }, "description": "ISP 3 Gateway IP" }, { "name": "isp3Iface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether3-ISP3" }, "description": "ISP 3 Interface" }, { "name": "isp4Bw", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "ISP 4 Bandwidth (Mbps)" }, { "name": "isp4Gw", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.4.1" }, "description": "ISP 4 Gateway IP" }, { "name": "isp4Iface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether4-ISP4" }, "description": "ISP 4 Interface" }, { "name": "isp5Bw", "in": "query", "required": false, "schema": { "type": "number", "default": 20 }, "description": "ISP 5 Bandwidth (Mbps)" }, { "name": "isp5Gw", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.5.1" }, "description": "ISP 5 Gateway IP" }, { "name": "isp5Iface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether5-ISP5" }, "description": "ISP 5 Interface" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mikrotik-pcc-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mikrotik-nat-calculator": { "get": { "summary": "MikroTik Port Forwarding (DST-NAT) and Hairpin NAT Generator", "description": "Expose internal server/NVR ports to the public internet (DST-NAT) and eliminate local loopback timeouts using Hairpin NAT.", "operationId": "calculate_mikrotik_nat_calculator", "parameters": [ { "name": "desc", "in": "query", "required": false, "schema": { "type": "string", "default": "NVR-CCTV-Server" }, "description": "Service / Server Description" }, { "name": "pubIp", "in": "query", "required": false, "schema": { "type": "string", "default": "203.142.77.10" }, "description": "Public WAN IP / DDNS Hostname" }, { "name": "extPort", "in": "query", "required": false, "schema": { "type": "string", "default": "8000" }, "description": "External Port (Public)" }, { "name": "intIp", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.250" }, "description": "Internal Server IP (LAN)" }, { "name": "intPort", "in": "query", "required": false, "schema": { "type": "string", "default": "8000" }, "description": "Internal Server Port" }, { "name": "proto", "in": "query", "required": false, "schema": { "type": "string", "default": "tcp" }, "description": "Transport Protocol" }, { "name": "lanCidr", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.0/24" }, "description": "LAN Subnet (Hairpin NAT Loopback)" }, { "name": "wanIface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether1-ISP" }, "description": "WAN Interface (ISP)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mikrotik-nat-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mikrotik-qos-calculator": { "get": { "summary": "MikroTik QoS Priority and Anti-Lag Calculator", "description": "Prioritize WhatsApp calls, Zoom/Teams conferences, and gaming latency above bulk downloads using RouterOS v7 FQ-CoDel Queue Trees.", "operationId": "calculate_mikrotik_qos_calculator", "parameters": [ { "name": "downMbps", "in": "query", "required": false, "schema": { "type": "number", "default": 100 }, "description": "Measured ISP Download Bandwidth (Mbps)" }, { "name": "upMbps", "in": "query", "required": false, "schema": { "type": "number", "default": 40 }, "description": "Measured ISP Upload Bandwidth (Mbps)" }, { "name": "headroomPct", "in": "query", "required": false, "schema": { "type": "number", "default": 95 }, "description": "ISP Shaping Headroom (%)" }, { "name": "prioDownPct", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Priority 1 Real-Time Download Allocation (%)" }, { "name": "prioUpPct", "in": "query", "required": false, "schema": { "type": "number", "default": 35 }, "description": "Priority 1 Real-Time Upload Allocation (%)" }, { "name": "wanIface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether1-ISP" }, "description": "WAN Interface (ISP)" }, { "name": "lanCidr", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.0/24" }, "description": "LAN Subnet (CIDR)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mikrotik-qos-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mtu-calculator": { "get": { "summary": "MTU and TCP MSS Clamping Calculator", "description": "Calculate optimal MTU sizes, TCP MSS clamping (IPv4/IPv6), and Don't Fragment ping payloads to resolve web page freezes over PPPoE and VPN tunnels.", "operationId": "calculate_mtu_calculator", "parameters": [ { "name": "linkType", "in": "query", "required": false, "schema": { "type": "string", "default": "pppoe" }, "description": "Connection Type / Tunnel Encapsulation" }, { "name": "ipVersion", "in": "query", "required": false, "schema": { "type": "string", "default": "ipv4" }, "description": "IP Protocol Version" }, { "name": "customMtu", "in": "query", "required": false, "schema": { "type": "number", "default": 1500 }, "description": "Custom MTU Value (Bytes)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mtu-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mikrotik-wireguard-mtu-calculator": { "get": { "summary": "MikroTik WireGuard VPN MTU & MSS Calculator", "description": "Deploy site-to-site WireGuard VPN on RouterOS v7 with automatic TCP MSS Clamping to prevent tunnel web page freezes and PMTUD black holes.", "operationId": "calculate_mikrotik_wireguard_mtu_calculator", "parameters": [ { "name": "linkType", "in": "query", "required": false, "schema": { "type": "string", "default": "pppoe" }, "description": "Router WAN Connection Type" }, { "name": "wanIface", "in": "query", "required": false, "schema": { "type": "string", "default": "pppoe-out1" }, "description": "Router WAN Interface Name" }, { "name": "wgPort", "in": "query", "required": false, "schema": { "type": "number", "default": 13231 }, "description": "WireGuard UDP Listen Port" }, { "name": "wgNet", "in": "query", "required": false, "schema": { "type": "string", "default": "10.200.200.1/24" }, "description": "WireGuard Tunnel Gateway IP" }, { "name": "peerIp", "in": "query", "required": false, "schema": { "type": "string", "default": "10.200.200.2/32" }, "description": "Branch Peer Tunnel IP" }, { "name": "remoteLan", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.90.0/24" }, "description": "Remote Branch LAN Subnet" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mikrotik-wireguard-mtu-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/zfs-raid-calculator": { "get": { "summary": "Proxmox ZFS & Hardware RAID Capacity Calculator", "description": "Calculate net usable Proxmox VE ZFS capacity, padding loss, slop space, 80% safe ceiling, ARC RAM, and zpool create CLI script.", "operationId": "calculate_zfs_raid_calculator", "parameters": [ { "name": "drives", "in": "query", "required": false, "schema": { "type": "number", "default": 6 }, "description": "Total Physical Drives" }, { "name": "driveSize", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Capacity per Drive" }, { "name": "unit", "in": "query", "required": false, "schema": { "type": "string", "default": "TB" }, "description": "Capacity Unit" }, { "name": "topology", "in": "query", "required": false, "schema": { "type": "string", "default": "raidz2" }, "description": "ZFS Redundancy Topology" }, { "name": "ashift", "in": "query", "required": false, "schema": { "type": "string", "default": "12" }, "description": "Pool ashift (Sector Alignment)" }, { "name": "recordsize", "in": "query", "required": false, "schema": { "type": "string", "default": "128" }, "description": "Dataset recordsize" }, { "name": "mediaType", "in": "query", "required": false, "schema": { "type": "string", "default": "ssd" }, "description": "Storage Media Type" }, { "name": "poolName", "in": "query", "required": false, "schema": { "type": "string", "default": "rpool-data" }, "description": "Proxmox ZFS Pool Name" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "zfs-raid-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/raid-calculator": { "get": { "summary": "RAID 0/1/5/6/10 Capacity Calculator", "description": "Calculate usable storage, parity loss, disk efficiency, and fault tolerance across RAID 0, 1, 5, 6, 10, 50, and 60 configurations.", "operationId": "calculate_raid_calculator", "parameters": [ { "name": "drives", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Total Physical Drives" }, { "name": "driveSize", "in": "query", "required": false, "schema": { "type": "number", "default": 2 }, "description": "Capacity per Drive" }, { "name": "unit", "in": "query", "required": false, "schema": { "type": "string", "default": "TB" }, "description": "Capacity Unit" }, { "name": "raidType", "in": "query", "required": false, "schema": { "type": "string", "default": "raid5" }, "description": "RAID Level" }, { "name": "hotSpares", "in": "query", "required": false, "schema": { "type": "number", "default": 0 }, "description": "Dedicated Hot Spare Drives" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "raid-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/server-ups-calculator": { "get": { "summary": "Server UPS VA/kVA & Battery Runtime Calculator", "description": "Calculate server UPS capacity (kVA/VA), VRLA battery runtime (Ah), and 24/7 monthly electricity cost with 25% safety margin and power factor.", "operationId": "calculate_server_ups_calculator", "parameters": [ { "name": "loadWatts", "in": "query", "required": false, "schema": { "type": "number", "default": 850 }, "description": "Active Server IT Load" }, { "name": "powerFactor", "in": "query", "required": false, "schema": { "type": "string", "default": 0.9 }, "description": "Power Factor (PF)" }, { "name": "targetMins", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Target Backup Runtime" }, { "name": "busVoltage", "in": "query", "required": false, "schema": { "type": "string", "default": 48 }, "description": "DC Battery Bus Voltage" }, { "name": "plnTariffRp", "in": "query", "required": false, "schema": { "type": "number", "default": 1444.7 }, "description": "Electricity Tariff" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "server-ups-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/server-cooling-calculator": { "get": { "summary": "Server Room Cooling (BTU/hr & PK) & Rack Unit Calculator", "description": "Calculate server room heat dissipation in BTU/hr, convert to air conditioning PK ratings with 24/7 redundancy, and size server racks with airflow buffer.", "operationId": "calculate_server_cooling_calculator", "parameters": [ { "name": "itEquipmentWatt", "in": "query", "required": false, "schema": { "type": "number", "default": 1200 }, "description": "Active IT Equipment Power" }, { "name": "upsRatingWatt", "in": "query", "required": false, "schema": { "type": "number", "default": 1500 }, "description": "UPS Capacity Rating" }, { "name": "roomAreaSqm", "in": "query", "required": false, "schema": { "type": "number", "default": 12 }, "description": "Floor Area" }, { "name": "staffCount", "in": "query", "required": false, "schema": { "type": "number", "default": 1 }, "description": "Average Personnel Inside" }, { "name": "usedRackUnits", "in": "query", "required": false, "schema": { "type": "number", "default": 14 }, "description": "Occupied Rack Units (U)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "server-cooling-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/vm-sizing-calculator": { "get": { "summary": "VM Host Sizing (vCPU/RAM) & Backup Time Calculator", "description": "Calculate physical CPU cores, host RAM sizing with ZFS ARC cache buffer for Proxmox/ESXi, and network backup data transfer duration (RTO).", "operationId": "calculate_vm_sizing_calculator", "parameters": [ { "name": "vmLightCount", "in": "query", "required": false, "schema": { "type": "number", "default": 6 }, "description": "Light VM Count (2 vCPU, 2 GB)" }, { "name": "vmMedCount", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Medium VM Count (4 vCPU, 8 GB)" }, { "name": "vmHeavyCount", "in": "query", "required": false, "schema": { "type": "number", "default": 2 }, "description": "Heavy VM Count (8 vCPU, 16 GB)" }, { "name": "overcommit", "in": "query", "required": false, "schema": { "type": "number", "default": 3 }, "description": "vCPU Overcommit Ratio" }, { "name": "backupDataTb", "in": "query", "required": false, "schema": { "type": "number", "default": 2 }, "description": "Backup Data Volume" }, { "name": "linkSpeedMbps", "in": "query", "required": false, "schema": { "type": "string", "default": 1000 }, "description": "Backup Network Link Speed" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "vm-sizing-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/wifi-ap-calculator": { "get": { "summary": "Wi-Fi Access Point & PoE Switch Capacity Calculator", "description": "Calculate Wi-Fi access point counts by coverage area and client capacity, PoE switch power budget, and minimum ISP internet line bandwidth.", "operationId": "calculate_wifi_ap_calculator", "parameters": [ { "name": "areaSqm", "in": "query", "required": false, "schema": { "type": "number", "default": 300 }, "description": "Building Area" }, { "name": "floors", "in": "query", "required": false, "schema": { "type": "number", "default": 1 }, "description": "Number of Floors" }, { "name": "envType", "in": "query", "required": false, "schema": { "type": "string", "default": "office" }, "description": "Environment & Wall Partition Type" }, { "name": "totalUsers", "in": "query", "required": false, "schema": { "type": "number", "default": 80 }, "description": "Total Concurrent Active Users" }, { "name": "wifiGen", "in": "query", "required": false, "schema": { "type": "string", "default": "wifi6" }, "description": "Wi-Fi Generation Standard" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "wifi-ap-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/fiber-loss-budget-calculator": { "get": { "summary": "Fiber Optic Loss Budget (dBm) & UTP Cable Box Calculator", "description": "Calculate GPON/EPON optical link loss budget (dBm), passive splitter loss, splicing, and estimate bulk UTP Ethernet cable boxes and RJ45s.", "operationId": "calculate_fiber_loss_budget_calculator", "parameters": [ { "name": "txPowerDbm", "in": "query", "required": false, "schema": { "type": "number", "default": 3.5 }, "description": "Optical TX Launch Power (SFP OLT)" }, { "name": "fiberLengthKm", "in": "query", "required": false, "schema": { "type": "number", "default": 2.5 }, "description": "Fiber Route Length" }, { "name": "wavelengthNm", "in": "query", "required": false, "schema": { "type": "string", "default": 1310 }, "description": "Optical Wavelength" }, { "name": "spliceCount", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Fusion Splice Joints" }, { "name": "connectorCount", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Mated Connector Pairs" }, { "name": "splitterRatio", "in": "query", "required": false, "schema": { "type": "string", "default": "1:8" }, "description": "Passive PLC Splitter Ratio" }, { "name": "lanDropPoints", "in": "query", "required": false, "schema": { "type": "number", "default": 24 }, "description": "Planned LAN Copper Drops" }, { "name": "avgDropLengthM", "in": "query", "required": false, "schema": { "type": "number", "default": 35 }, "description": "Average LAN Drop Length" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "fiber-loss-budget-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/dbm-converter": { "get": { "summary": "dBm to mW Converter & Free Space Path Loss (FSPL) Calculator", "description": "Convert RF power between dBm, milliwatts (mW), Watts, and dBW, and calculate Free Space Path Loss (FSPL) attenuation for wireless radio links.", "operationId": "calculate_dbm_converter", "parameters": [ { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "dbm-to-mw" }, "description": "Calculation Mode" }, { "name": "powerDbm", "in": "query", "required": false, "schema": { "type": "number", "default": 20 }, "description": "Power Level (dBm)" }, { "name": "powerMw", "in": "query", "required": false, "schema": { "type": "number", "default": 100 }, "description": "Power Level (mW)" }, { "name": "distanceKm", "in": "query", "required": false, "schema": { "type": "number", "default": 5 }, "description": "Link Propagation Distance" }, { "name": "frequencyGhz", "in": "query", "required": false, "schema": { "type": "number", "default": 5.8 }, "description": "Radio Carrier Frequency" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "dbm-converter" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/wireless-ptp-calculator": { "get": { "summary": "Wireless PtP Link Budget & Fresnel Zone Calculator", "description": "Calculate received RX signal (dBm), free-space path loss FSPL, 60% Fresnel clearance, earth curvature bulge, and minimum triangle tower heights.", "operationId": "calculate_wireless_ptp_calculator", "parameters": [ { "name": "distKm", "in": "query", "required": false, "schema": { "type": "number", "default": 5 }, "description": "Wireless Link Distance" }, { "name": "freqGhz", "in": "query", "required": false, "schema": { "type": "number", "default": 5.8 }, "description": "Carrier Radio Frequency" }, { "name": "txDbm", "in": "query", "required": false, "schema": { "type": "number", "default": 24 }, "description": "Radio TX Power" }, { "name": "antGainDbi", "in": "query", "required": false, "schema": { "type": "number", "default": 23 }, "description": "Dish Antenna Gain (Per Side)" }, { "name": "obstacleM", "in": "query", "required": false, "schema": { "type": "number", "default": 12 }, "description": "Midpoint Obstacle Height" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "wireless-ptp-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/cctv-lens-calculator": { "get": { "summary": "CCTV Lens Selection & Field of View Calculator", "description": "Calculate CCTV lens focal length recommendations (2.8mm, 4mm, 6mm, 12mm), field of view coverage width, and DORI pixel density per target distance.", "operationId": "calculate_cctv_lens_calculator", "parameters": [ { "name": "targetDistM", "in": "query", "required": false, "schema": { "type": "number", "default": 8 }, "description": "Target Object Distance" }, { "name": "resolution", "in": "query", "required": false, "schema": { "type": "string", "default": "1080p" }, "description": "Camera Sensor Resolution" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "cctv-lens-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/dori-calculator": { "get": { "summary": "CCTV DORI Distance Calculator (EN 62676-4)", "description": "Calculate EN 62676-4 CCTV DORI detection, observation, recognition, and facial identification reach distances based on sensor resolution and lens optics.", "operationId": "calculate_dori_calculator", "parameters": [ { "name": "targetDistM", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Target Distance" }, { "name": "resolution", "in": "query", "required": false, "schema": { "type": "string", "default": "1080p" }, "description": "Camera Sensor Resolution" }, { "name": "focalMm", "in": "query", "required": false, "schema": { "type": "string", "default": 4 }, "description": "Lens Focal Length" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "dori-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/poe-voltage-drop-calculator": { "get": { "summary": "PoE Cable Voltage Drop Calculator", "description": "Calculate PoE Cat6, Cat5e, and CCA cable voltage drop, delivered terminal voltage, safe run distances, and night-time infrared reboot risks.", "operationId": "calculate_poe_voltage_drop_calculator", "parameters": [ { "name": "cableLenM", "in": "query", "required": false, "schema": { "type": "number", "default": 65 }, "description": "Cable Run Length" }, { "name": "cableType", "in": "query", "required": false, "schema": { "type": "string", "default": "cat6" }, "description": "Cable Conductor Type" }, { "name": "camPowerWatt", "in": "query", "required": false, "schema": { "type": "number", "default": 8 }, "description": "Device Load Power (Watts)" }, { "name": "sourceVoltage", "in": "query", "required": false, "schema": { "type": "string", "default": 48 }, "description": "PoE Switch Source Voltage" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "poe-voltage-drop-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/cctv-storage-calculator": { "get": { "summary": "CCTV NVR Storage Capacity & Bandwidth Calculator", "description": "Calculate CCTV NVR storage capacity (TB), network ingress bandwidth Mbps, recording retention days, PoE budgets, and surveillance HDD recommendations.", "operationId": "calculate_cctv_storage_calculator", "parameters": [ { "name": "camCount", "in": "query", "required": false, "schema": { "type": "number", "default": 16 }, "description": "IP Camera Count" }, { "name": "days", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Target Retention Days" }, { "name": "hours", "in": "query", "required": false, "schema": { "type": "number", "default": 24 }, "description": "Daily Recording Hours" }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "motion" }, "description": "Recording Trigger Mode" }, { "name": "motionPct", "in": "query", "required": false, "schema": { "type": "number", "default": 40 }, "description": "Motion Activity Ratio (%)" }, { "name": "resolution", "in": "query", "required": false, "schema": { "type": "string", "default": "2mp" }, "description": "Camera Sensor Resolution" }, { "name": "codec", "in": "query", "required": false, "schema": { "type": "string", "default": "h265+" }, "description": "Video Codec Compression" }, { "name": "fps", "in": "query", "required": false, "schema": { "type": "number", "default": 25 }, "description": "Frame Rate (FPS)" }, { "name": "quality", "in": "query", "required": false, "schema": { "type": "string", "default": "high" }, "description": "Video Quality Profile" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "cctv-storage-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/cctv-bom-estimator": { "get": { "summary": "CCTV Installation Material BOM Estimator", "description": "Estimate CCTV installation material Bill of Materials (BOM): Cat6 UTP cable boxes, RJ45 modular plugs, junction boxes, conduit pipes, and cable ties.", "operationId": "calculate_cctv_bom_estimator", "parameters": [ { "name": "indoorCams", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Indoor Dome Cameras" }, { "name": "outdoorCams", "in": "query", "required": false, "schema": { "type": "number", "default": 6 }, "description": "Outdoor Bullet/PTZ Cameras" }, { "name": "avgCableM", "in": "query", "required": false, "schema": { "type": "number", "default": 35 }, "description": "Average Cable Length per Camera" }, { "name": "useConduit", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "PVC Conduit Piping Protection" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "cctv-bom-estimator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/cctv-ups-calculator": { "get": { "summary": "CCTV UPS & Battery Backup Calculator", "description": "Calculate CCTV camera, NVR, and PoE switch UPS apparent power (VA) and deep-cycle VRLA battery capacity (Ah) for power outage runtime.", "operationId": "calculate_cctv_ups_calculator", "parameters": [ { "name": "camCount", "in": "query", "required": false, "schema": { "type": "number", "default": 16 }, "description": "Active IP Camera Count" }, { "name": "camWatt", "in": "query", "required": false, "schema": { "type": "number", "default": 7.5 }, "description": "Night-Time Power per Camera" }, { "name": "nvrHddCount", "in": "query", "required": false, "schema": { "type": "number", "default": 2 }, "description": "NVR Hard Drive Count" }, { "name": "poeSwitches", "in": "query", "required": false, "schema": { "type": "number", "default": 1 }, "description": "PoE Switch Appliance Count" }, { "name": "backupHours", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Target Backup Runtime" }, { "name": "battVoltage", "in": "query", "required": false, "schema": { "type": "string", "default": 12 }, "description": "DC Battery Bus Voltage" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "cctv-ups-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/cron-generator": { "get": { "summary": "Linux Cron Job Expression & Crontab Schedule Generator", "description": "POSIX 5-field cron expression generator, production crontab line builder, next 5 execution timestamps, and systemd timer unit converter.", "operationId": "calculate_cron_generator", "parameters": [ { "name": "preset", "in": "query", "required": false, "schema": { "type": "string", "default": "daily_midnight" }, "description": "Popular Schedule Preset" }, { "name": "expression", "in": "query", "required": false, "schema": { "type": "string", "default": "0 0 * * *" }, "description": "Cron Expression (5 or 6 Fields)" }, { "name": "timezone", "in": "query", "required": false, "schema": { "type": "string", "default": "Asia/Jakarta" }, "description": "Target Execution Timezone" }, { "name": "command", "in": "query", "required": false, "schema": { "type": "string", "default": "/usr/local/bin/backup-job.sh" }, "description": "Command / Script to Execute" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "cron-generator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/chmod-calculator": { "get": { "summary": "Linux Chmod File Permissions Calculator (Octal & Symbolic)", "description": "Convert Linux chmod octal (755, 644, 4750) and symbolic (-rwxr-xr-x) permissions, calculate umask, audit 777 security risks, and view breakdown tables.", "operationId": "calculate_chmod_calculator", "parameters": [ { "name": "preset", "in": "query", "required": false, "schema": { "type": "string", "default": "p755" }, "description": "Standard Linux Permission Preset" }, { "name": "octal", "in": "query", "required": false, "schema": { "type": "string", "default": "755" }, "description": "Octal Permission Value (3 or 4 Digits)" }, { "name": "umask", "in": "query", "required": false, "schema": { "type": "string", "default": "022" }, "description": "System Umask Value (Default Creation Filter)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "chmod-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/linux-firewall-generator": { "get": { "summary": "Linux Firewall Generator (UFW, Iptables & Nftables)", "description": "Generate production Linux server firewall rulesets for UFW, iptables, and /etc/nftables.conf with SSH rate-limiting and trusted subnet whitelisting.", "operationId": "calculate_linux_firewall_generator", "parameters": [ { "name": "defaultPolicy", "in": "query", "required": false, "schema": { "type": "string", "default": "drop" }, "description": "Default Inbound Policy" }, { "name": "wanInterface", "in": "query", "required": false, "schema": { "type": "string", "default": "eth0" }, "description": "WAN Network Interface Name" }, { "name": "sshPort", "in": "query", "required": false, "schema": { "type": "number", "default": 22 }, "description": "SSH Server TCP Port" }, { "name": "sshRateLimit", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Enable SSH Brute-Force Rate-Limiting" }, { "name": "allowHttp", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Allow HTTP Web Server (Port 80/TCP)" }, { "name": "allowHttps", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Allow HTTPS TLS Web Server (Port 443/TCP)" }, { "name": "allowWireguard", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Allow WireGuard VPN Tunnel (UDP)" }, { "name": "wireguardPort", "in": "query", "required": false, "schema": { "type": "number", "default": 51820 }, "description": "WireGuard UDP Port" }, { "name": "allowProxmox", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Allow Proxmox VE Web GUI (Port 8006/TCP from Trusted Subnet)" }, { "name": "allowDatabase", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Allow MySQL/PostgreSQL (3306 & 5432 from Trusted Subnet)" }, { "name": "trustedSubnet", "in": "query", "required": false, "schema": { "type": "string", "default": "10.10.10.0/24" }, "description": "Trusted Management Subnet (CIDR)" }, { "name": "allowIcmpPing", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Allow ICMP Echo Request Diagnostics (Ping)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "linux-firewall-generator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/linux-swap-tuning-calculator": { "get": { "summary": "Linux Swap Size, Swappiness & Ext4 Inode Calculator", "description": "Calculate optimal Linux swap size, vm.swappiness, vm.vfs_cache_pressure sysctl tunables, default ext4 inode count, and /swapfile creation script.", "operationId": "calculate_linux_swap_tuning_calculator", "parameters": [ { "name": "ramGb", "in": "query", "required": false, "schema": { "type": "number", "default": 16 }, "description": "Physical Server RAM Capacity (GB)" }, { "name": "workloadProfile", "in": "query", "required": false, "schema": { "type": "string", "default": "web_container" }, "description": "Server Workload Profile" }, { "name": "diskType", "in": "query", "required": false, "schema": { "type": "string", "default": "nvme_ssd" }, "description": "Storage Disk Media Type" }, { "name": "partitionSizeGb", "in": "query", "required": false, "schema": { "type": "number", "default": 200 }, "description": "ext4 Storage Partition Size (GB)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "linux-swap-tuning-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/password-entropy-calculator": { "get": { "summary": "Password Entropy & Brute-Force Crack Time Calculator", "description": "Calculate cryptographic password entropy bits (E = L × log2(R)), total keyspace combinations, and brute-force crack times across Bcrypt and GPU rigs.", "operationId": "calculate_password_entropy_calculator", "parameters": [ { "name": "length", "in": "query", "required": false, "schema": { "type": "number", "default": 16 }, "description": "Password Character Length (8 - 128)" }, { "name": "includeUppercase", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Include Uppercase Letters (A-Z)" }, { "name": "includeLowercase", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Include Lowercase Letters (a-z)" }, { "name": "includeNumbers", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Include Numeric Digits (0-9)" }, { "name": "includeSymbols", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Include Special Symbols (!@#$%^&*...)" }, { "name": "excludeAmbiguous", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Exclude Ambiguous Characters (0, O, o, 1, l, I, |)" }, { "name": "seed", "in": "query", "required": false, "schema": { "type": "string", "default": "" }, "description": "Custom Seed (Optional — for Deterministic Reproducibility)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "password-entropy-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/jwt-size-calculator": { "get": { "summary": "JWT Token Size, Base64URL Overhead & TTL Calculator", "description": "Calculate JWT token byte size (HS256, RS256, ES256, EdDSA), Base64URL overhead, 4 KB browser cookie and 8 KB Nginx header limits, and monthly bandwidth.", "operationId": "calculate_jwt_size_calculator", "parameters": [ { "name": "algorithm", "in": "query", "required": false, "schema": { "type": "string", "default": "RS256" }, "description": "Cryptographic Signing Algorithm (JWS)" }, { "name": "payloadJsonBytes", "in": "query", "required": false, "schema": { "type": "number", "default": 280 }, "description": "Base Payload JSON Size (Bytes)" }, { "name": "customClaimCount", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Additional Custom Claims Count" }, { "name": "ttlMinutes", "in": "query", "required": false, "schema": { "type": "number", "default": 60 }, "description": "Token Time-To-Live / TTL (Minutes)" }, { "name": "requestsPerDay", "in": "query", "required": false, "schema": { "type": "number", "default": 100000 }, "description": "Average API Requests per Day" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "jwt-size-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/vpn-encryption-overhead-calculator": { "get": { "summary": "VPN Encryption Overhead & Tunnel MTU Calculator (WireGuard, IPsec, OpenVPN)", "description": "Calculate cryptographic encapsulation overhead, optimal tunnel MTU, TCP MSS clamping, and effective payload throughput for WireGuard, IPsec, and OpenVPN.", "operationId": "calculate_vpn_encryption_overhead_calculator", "parameters": [ { "name": "physicalWanMtu", "in": "query", "required": false, "schema": { "type": "number", "default": 1500 }, "description": "Physical WAN Interface MTU (Bytes)" }, { "name": "ipVersion", "in": "query", "required": false, "schema": { "type": "string", "default": "ipv4" }, "description": "Outer Carrier IP Protocol Version" }, { "name": "vpnProtocol", "in": "query", "required": false, "schema": { "type": "string", "default": "wireguard" }, "description": "VPN Tunnel Protocol & Cipher Suite" }, { "name": "linkSpeedMbps", "in": "query", "required": false, "schema": { "type": "number", "default": 100 }, "description": "WAN Link Bandwidth Speed (Mbps)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "vpn-encryption-overhead-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/security-log-storage-calculator": { "get": { "summary": "SIEM Security Log Storage, EPS & Audit Retention Calculator", "description": "Calculate aggregate Events Per Second (EPS), daily raw log volume, indexed Hot Storage, and compressed Cold Archive capacity for Wazuh & Elastic SIEM.", "operationId": "calculate_security_log_storage_calculator", "parameters": [ { "name": "networkDevicesCount", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Network Appliances & Firewalls Count" }, { "name": "serversCount", "in": "query", "required": false, "schema": { "type": "number", "default": 25 }, "description": "Production Servers & Endpoints Count" }, { "name": "avgEpsPerDevice", "in": "query", "required": false, "schema": { "type": "number", "default": 15 }, "description": "Average Events Per Second (EPS) per Device" }, { "name": "avgBytesPerEvent", "in": "query", "required": false, "schema": { "type": "number", "default": 350 }, "description": "Average Size per Log Event (Bytes)" }, { "name": "hotRetentionDays", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Indexed Hot Storage Retention (Days)" }, { "name": "coldRetentionDays", "in": "query", "required": false, "schema": { "type": "number", "default": 335 }, "description": "Compressed Cold Archive Retention (Days)" }, { "name": "compressionRatio", "in": "query", "required": false, "schema": { "type": "number", "default": 5 }, "description": "Cold Archive Compression Ratio (e.g. 5 for 5:1)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "security-log-storage-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/storage-unit-converter": { "get": { "summary": "Data Storage Unit Converter (TB vs TiB, GB vs GiB, Decimal vs Binary)", "description": "Convert accurately between manufacturer decimal SI units (KB, MB, GB, TB, PB) and operating system binary IEC 80000-13 units (KiB, MiB, GiB, TiB, PiB).", "operationId": "calculate_storage_unit_converter", "parameters": [ { "name": "value", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Storage Capacity Magnitude" }, { "name": "inputUnit", "in": "query", "required": false, "schema": { "type": "string", "default": "TB" }, "description": "Initial Capacity Unit" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "storage-unit-converter" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/data-transfer-time-calculator": { "get": { "summary": "Network Data Transfer, Backup Window & Sync Time Calculator", "description": "Calculate file transfer duration, offsite backup windows, and effective throughput (Mbps, MB/s, MiB/s) accounting for TCP/IP protocol overhead.", "operationId": "calculate_data_transfer_time_calculator", "parameters": [ { "name": "fileSize", "in": "query", "required": false, "schema": { "type": "number", "default": 50 }, "description": "File Size / Data Volume" }, { "name": "fileSizeUnit", "in": "query", "required": false, "schema": { "type": "string", "default": "GB" }, "description": "File Size Unit" }, { "name": "linkSpeed", "in": "query", "required": false, "schema": { "type": "number", "default": 1000 }, "description": "Network Link Bandwidth" }, { "name": "linkSpeedUnit", "in": "query", "required": false, "schema": { "type": "string", "default": "Mbps" }, "description": "Bandwidth Speed Unit" }, { "name": "overheadPct", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Protocol & Retransmission Overhead (%)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "data-transfer-time-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/sla-uptime-calculator": { "get": { "summary": "SLA Uptime, Allowed Downtime & SRE Error Budget Calculator", "description": "Calculate maximum allowed daily, monthly, and yearly downtime from SLA targets (99.9%–99.999%) or audit achieved SLA from observed incident duration.", "operationId": "calculate_sla_uptime_calculator", "parameters": [ { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "forward" }, "description": "Calculation Direction / Mode" }, { "name": "availabilityPct", "in": "query", "required": false, "schema": { "type": "number", "default": 99.9 }, "description": "Target Availability SLA (%) (Forward Mode)" }, { "name": "downtimeValue", "in": "query", "required": false, "schema": { "type": "number", "default": 45 }, "description": "Total Logged Outage / Downtime Duration (Reverse Mode)" }, { "name": "downtimeUnit", "in": "query", "required": false, "schema": { "type": "string", "default": "minutes" }, "description": "Downtime Time Unit (Reverse Mode)" }, { "name": "downtimePeriod", "in": "query", "required": false, "schema": { "type": "string", "default": "month" }, "description": "SLA Evaluation / Reporting Period (Reverse Mode)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "sla-uptime-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/it-power-cost-calculator": { "get": { "summary": "IT Equipment Power Consumption (Watt, kWh), PUE & Electricity Cost Calculator", "description": "Calculate daily, monthly, and annual kWh energy usage, data center PUE overhead, monthly electricity bills, 220V MCB amperage, and BTU/hr heat load.", "operationId": "calculate_it_power_cost_calculator", "parameters": [ { "name": "itLoadWatts", "in": "query", "required": false, "schema": { "type": "number", "default": 850 }, "description": "Total IT Equipment Power Load (Watts)" }, { "name": "pueFactor", "in": "query", "required": false, "schema": { "type": "number", "default": 1.4 }, "description": "Facility PUE Factor (1.0 = Hardware Only)" }, { "name": "dailyOperatingHours", "in": "query", "required": false, "schema": { "type": "number", "default": 24 }, "description": "Daily Operating Hours (1–24h)" }, { "name": "tariffIdrPerKwh", "in": "query", "required": false, "schema": { "type": "number", "default": 1444.7 }, "description": "Electricity Tariff per kWh (IDR/kWh)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "it-power-cost-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/floorplan-wifi-cctv-planner": { "get": { "summary": "Interactive Floorplan Wi-Fi Heatmap & CCTV FoV Planner", "description": "Interactive 2D floorplan planner for estimating Wi-Fi AP 2.4/5GHz signal coverage radii and CCTV camera FoV DORI coverage cones visually.", "operationId": "calculate_floorplan_wifi_cctv_planner", "parameters": [ { "name": "buildingWidthM", "in": "query", "required": false, "schema": { "type": "number", "default": 20 }, "description": "Building Width (Meters)" }, { "name": "buildingLengthM", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Building Length (Meters)" }, { "name": "wallType", "in": "query", "required": false, "schema": { "type": "string", "default": "brick" }, "description": "Interior Wall Barrier Material" }, { "name": "apCount", "in": "query", "required": false, "schema": { "type": "number", "default": 3 }, "description": "Installed Access Points Count" }, { "name": "apTxPowerDbm", "in": "query", "required": false, "schema": { "type": "number", "default": 20 }, "description": "AP Transmit Power (Tx Power)" }, { "name": "cctvCount", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Installed CCTV Cameras Count" }, { "name": "lensFocalMm", "in": "query", "required": false, "schema": { "type": "string", "default": "2.8" }, "description": "CCTV Camera Lens Focal Length" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "floorplan-wifi-cctv-planner" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mikrotik-config-security-auditor": { "get": { "summary": "MikroTik RouterOS .rsc Config Security Auditor", "description": "Automated security audit for MikroTik RouterOS v7 .rsc export files, detecting misconfigurations, exposed services, and generating fix scripts.", "operationId": "calculate_mikrotik_config_security_auditor", "parameters": [ { "name": "wanInterface", "in": "query", "required": false, "schema": { "type": "string", "default": "ether1-wan" }, "description": "WAN Internet Interface Name" }, { "name": "lanSubnet", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.0/24" }, "description": "Trusted Management LAN Subnet" }, { "name": "winboxPort", "in": "query", "required": false, "schema": { "type": "number", "default": 8291 }, "description": "Current Winbox Service Port" }, { "name": "sshPort", "in": "query", "required": false, "schema": { "type": "number", "default": 22 }, "description": "Current SSH Service Port" }, { "name": "dnsAllowRemote", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "DNS 'Allow Remote Requests' Enabled" }, { "name": "hasInputDropRule", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Firewall Filters Drop WAN Port 53" }, { "name": "telnetFtpApiDisabled", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Telnet, FTP, WWW & API Services Disabled" }, { "name": "btestServerDisabled", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Bandwidth Test Server (BTest) Disabled" }, { "name": "neighborDiscoveryRestricted", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Neighbor Discovery Restricted to LAN Only" }, { "name": "defaultAdminRenamed", "in": "query", "required": false, "schema": { "type": "string", "default": false }, "description": "Default 'admin' User Renamed & Disabled" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mikrotik-config-security-auditor" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/fiber-color-code-rj45-simulator": { "get": { "summary": "TIA-598C Fiber Color Code & RJ45 Pinout Simulator", "description": "Visualizer for TIA-598C fiber optic color codes from 1 to 288 cores, tube mapping, and RJ45 LAN pinout diagrams (T568A/T568B) with PoE pairing.", "operationId": "calculate_fiber_color_code_rj45_simulator", "parameters": [ { "name": "targetCoreNumber", "in": "query", "required": false, "schema": { "type": "number", "default": 27 }, "description": "Target Core Number to Trace (1–288)" }, { "name": "coresPerTube", "in": "query", "required": false, "schema": { "type": "string", "default": "12" }, "description": "Cores Count per Loose Tube" }, { "name": "totalCableCores", "in": "query", "required": false, "schema": { "type": "string", "default": "48" }, "description": "Total Cable Core Capacity" }, { "name": "rj45Standard", "in": "query", "required": false, "schema": { "type": "string", "default": "T568B" }, "description": "RJ45 Pinout Wiring Standard" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "fiber-color-code-rj45-simulator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/cable-label-qr-generator": { "get": { "summary": "TIA-606-C Cable Label & Asset QR Code Generator", "description": "Print-ready ANSI/TIA-606-C cable wrap, patch panel strip, and asset QR tag generator for standardized, enterprise-grade structured cabling.", "operationId": "calculate_cable_label_qr_generator", "parameters": [ { "name": "floorCode", "in": "query", "required": false, "schema": { "type": "string", "default": "FL01" }, "description": "Building Floor Identifier" }, { "name": "rackCode", "in": "query", "required": false, "schema": { "type": "string", "default": "RK01" }, "description": "Server Cabinet / Rack Identifier" }, { "name": "switchCode", "in": "query", "required": false, "schema": { "type": "string", "default": "SW01" }, "description": "Switch / Patch Panel Identifier" }, { "name": "startPort", "in": "query", "required": false, "schema": { "type": "number", "default": 1 }, "description": "Starting Switch Port Number" }, { "name": "portCount", "in": "query", "required": false, "schema": { "type": "string", "default": "24" }, "description": "Number of Ports to Label" }, { "name": "vlanId", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Assigned Port VLAN ID" }, { "name": "ipSubnetPrefix", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.10" }, "description": "Host Subnet IP Prefix" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "cable-label-qr-generator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/it-bast-uat-checklist-generator": { "get": { "summary": "IT Project UAT Checklist & Handover BAST Generator", "description": "Generate formal User Acceptance Testing (UAT) checklists and project commissioning handover (BAST) documentation for enterprise IT deployments.", "operationId": "calculate_it_bast_uat_checklist_generator", "parameters": [ { "name": "projectScope", "in": "query", "required": false, "schema": { "type": "string", "default": "full_infrastructure" }, "description": "Project Scope of Work" }, { "name": "totalEndpoints", "in": "query", "required": false, "schema": { "type": "number", "default": 24 }, "description": "Total Endpoint Node Count" }, { "name": "targetUptimeSlaPct", "in": "query", "required": false, "schema": { "type": "number", "default": 99.5 }, "description": "Target Availability SLA Commitment" }, { "name": "retentionDays", "in": "query", "required": false, "schema": { "type": "number", "default": 30 }, "description": "Required Storage Retention Period" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "it-bast-uat-checklist-generator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/maintenance-window-timezone-planner": { "get": { "summary": "Multi-Timezone Maintenance Window & Cron Planner", "description": "Plan server maintenance windows across WIB, WITA, WIT, SGT, and UTC timezones with automated cron backup conflict detection and change notice.", "operationId": "calculate_maintenance_window_timezone_planner", "parameters": [ { "name": "startHourWita", "in": "query", "required": false, "schema": { "type": "string", "default": "1" }, "description": "Maintenance Start Hour (WITA Timezone)" }, { "name": "durationHours", "in": "query", "required": false, "schema": { "type": "number", "default": 2 }, "description": "Allocated Window Duration" }, { "name": "estimatedDowntimeMinutes", "in": "query", "required": false, "schema": { "type": "number", "default": 15 }, "description": "Estimated Service Downtime Minutes" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "maintenance-window-timezone-planner" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/gpon-ftth-splitter-cascade-calculator": { "get": { "summary": "GPON FTTH Cascade Splitter & Optical Tree Calculator", "description": "Calculate GPON/EPON optical link loss budget, simulate ODC/ODP cascade splitters (1:2 to 1:16, tap 15/85), and view ITU-T G.984 optical tree diagrams.", "operationId": "calculate_gpon_ftth_splitter_cascade_calculator", "parameters": [ { "name": "oltSfpClass", "in": "query", "required": false, "schema": { "type": "string", "default": "C_PLUS" }, "description": "OLT PON SFP Class" }, { "name": "oltTxPowerDbm", "in": "query", "required": false, "schema": { "type": "number", "default": 5 }, "description": "Measured OLT Tx Power (dBm)" }, { "name": "feederLengthKm", "in": "query", "required": false, "schema": { "type": "number", "default": 1.5 }, "description": "Feeder Fiber Length OLT to ODC (km)" }, { "name": "distributionLengthKm", "in": "query", "required": false, "schema": { "type": "number", "default": 0.8 }, "description": "Distribution Fiber Length ODC to ODP (km)" }, { "name": "dropCableLengthM", "in": "query", "required": false, "schema": { "type": "number", "default": 150 }, "description": "Drop Cable Length ODP to ONT (m)" }, { "name": "odcSplitterRatio", "in": "query", "required": false, "schema": { "type": "string", "default": "1:4" }, "description": "1st Stage ODC Splitter Ratio" }, { "name": "odpSplitterRatio", "in": "query", "required": false, "schema": { "type": "string", "default": "1:8" }, "description": "2nd Stage ODP Splitter Ratio" }, { "name": "cascadeRatioTap", "in": "query", "required": false, "schema": { "type": "string", "default": "NONE" }, "description": "FBT Unbalanced Tap Ratio" }, { "name": "spliceCount", "in": "query", "required": false, "schema": { "type": "number", "default": 6 }, "description": "Splice Joint Points Count" }, { "name": "connectorCount", "in": "query", "required": false, "schema": { "type": "number", "default": 6 }, "description": "SC/APC Connector Pairs" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "gpon-ftth-splitter-cascade-calculator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/mac-oui-dhcp-lease-inspector": { "get": { "summary": "MAC Vendor OUI & MikroTik DHCP Lease Conflict Inspector", "description": "Inspect bulk ARP tables and MikroTik DHCP leases, identify OUI vendors, detect randomized MACs, and catch duplicate IP network conflicts instantly.", "operationId": "calculate_mac_oui_dhcp_lease_inspector", "parameters": [ { "name": "singleMacOrDump", "in": "query", "required": false, "schema": { "type": "string", "default": "192.168.88.1 48:8F:5A:11:22:33 MikroTik-Core\n192.168.88.10 BC:24:11:AA:BB:01 pve-node1\n192.168.88.21 44:19:B6:00:11:22 IPCam-Lobby\n192.168.88.22 30:0D:9E:55:66:77 AP-Ruijie-Lt1\n192.168.88.55 DA:A1:19:12:34:56 iPhone-Guest" }, "description": "IP & MAC Address List (Paste DHCP / ARP Table)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "mac-oui-dhcp-lease-inspector" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/infrastructure-spec-duel-comparator": { "get": { "summary": "Infrastructure Spec Duel & Hardware ROI Comparator", "description": "Compare technical specifications of ZFS RAIDZ1 vs RAIDZ2 vs RAID10, CCTV H.264 vs H.265+ storage savings, and WireGuard vs IPsec vs OpenVPN throughput.", "operationId": "calculate_infrastructure_spec_duel_comparator", "parameters": [ { "name": "duelMode", "in": "query", "required": false, "schema": { "type": "string", "default": "STORAGE_RAID" }, "description": "Duel Comparison Mode" }, { "name": "diskOrCamCount", "in": "query", "required": false, "schema": { "type": "number", "default": 8 }, "description": "Drive Count / CCTV Cameras Quantity" }, { "name": "unitSizeTbOrDays", "in": "query", "required": false, "schema": { "type": "number", "default": 4 }, "description": "Disk Capacity (TB) / Retention (Days)" }, { "name": "hddPricePerTbIdr", "in": "query", "required": false, "schema": { "type": "number", "default": 450000 }, "description": "Enterprise Hard Drive Price per TB (IDR)" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "infrastructure-spec-duel-comparator" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/docker-nginx-stack-composer": { "get": { "summary": "Docker, Nginx & Linux Stack Visual Composer", "description": "Visually compose production container stacks: select Nginx/Cloudflare ingress, frontend, backend API, databases & Redis. Generates SVG topology, docker-compose.yml, and UFW scripts.", "operationId": "calculate_docker_nginx_stack_composer", "parameters": [ { "name": "projectName", "in": "query", "required": false, "schema": { "type": "string", "default": "kampus-app" }, "description": "Project Name (Slug)" }, { "name": "domainName", "in": "query", "required": false, "schema": { "type": "string", "default": "app.example.com" }, "description": "Production Domain" }, { "name": "edgeIngress", "in": "query", "required": false, "schema": { "type": "string", "default": "BOTH_NGINX_AND_CF" }, "description": "Edge Ingress & Proxy Tier" }, { "name": "frontendStack", "in": "query", "required": false, "schema": { "type": "string", "default": "NEXTJS_NODE" }, "description": "Frontend UI Tier" }, { "name": "backendStack", "in": "query", "required": false, "schema": { "type": "string", "default": "LARAVEL_OCTANE" }, "description": "Backend API Engine Tier" }, { "name": "databaseStack", "in": "query", "required": false, "schema": { "type": "string", "default": "POSTGRES_16" }, "description": "Isolated Database Tier" }, { "name": "enableRedisCache", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Enable Redis 7.4 In-Memory Cache (:6379)" }, { "name": "enableUptimeKuma", "in": "query", "required": false, "schema": { "type": "string", "default": true }, "description": "Enable Uptime Kuma Health Monitoring (:3001)" }, { "name": "sshCustomPort", "in": "query", "required": false, "schema": { "type": "number", "default": 22 }, "description": "VPS SSH Port for UFW Firewall" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "docker-nginx-stack-composer" }, "data": { "type": "object" } } } } } } } } }, "/api/v1/calculate/api-capacity-rate-limit-calculator": { "get": { "summary": "API Capacity & Rate Limit Calculator", "description": "Calculate sustained & burst peak RPS (Little's Law L=λW), concurrent in-flight requests, required vCPU cores, and Nginx rate-limiting rules.", "operationId": "calculate_api_capacity_rate_limit_calculator", "parameters": [ { "name": "dailyActiveUsers", "in": "query", "required": false, "schema": { "type": "number", "default": 25000 }, "description": "Daily Active Users (DAU)" }, { "name": "requestsPerUserPerDay", "in": "query", "required": false, "schema": { "type": "number", "default": 40 }, "description": "Requests per User / Day" }, { "name": "peakHourTrafficRatioPct", "in": "query", "required": false, "schema": { "type": "number", "default": 20 }, "description": "Peak Hour Traffic Concentration (%)" }, { "name": "burstMultiplier", "in": "query", "required": false, "schema": { "type": "number", "default": 3 }, "description": "Instantaneous Burst Multiplier" }, { "name": "avgResponsePayloadKb", "in": "query", "required": false, "schema": { "type": "number", "default": 18 }, "description": "Average Response Payload Size (KB)" }, { "name": "avgEndpointLatencyMs", "in": "query", "required": false, "schema": { "type": "number", "default": 45 }, "description": "Average Endpoint Latency (ms)" }, { "name": "workerConcurrencyPerCore", "in": "query", "required": false, "schema": { "type": "number", "default": 100 }, "description": "Worker Concurrency per vCPU Core" } ], "responses": { "200": { "description": "Calculation results executed via KalkuNet pure TypeScript engine", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 200 }, "engine": { "type": "string", "example": "KalkuNet Calc API v1" }, "tool": { "type": "string", "example": "api-capacity-rate-limit-calculator" }, "data": { "type": "object" } } } } } } } } } } }