A modern platform for visual, flexible, and extensible graph-based investigations. For cybersecurity analysts and investigators.
import time
from typing import Any, Dict, Optional
import requests
from ..base import Tool
class WhoxyTool(Tool):
whoxy_api_endoint = "https://api.whoxy.com/"
MAX_RETRIES = 3
INITIAL_DELAY = 2 # seconds
@classmethod
def name(cls) -> str:
return "whoxy"
@classmethod
def version(cls) -> str:
return "1.0.0"
@classmethod
def description(cls) -> str:
return "The WHOIS API returns consistent and well-structured WHOIS data in XML & JSON format. Returned data contain parsed WHOIS fields that can be easily understood. Along with WHOIS API, Whoxy also offer WHOIS History API and Reverse WHOIS API."
@classmethod
def category(cls) -> str:
return "Network intelligence"
# Whoxy's response is a single JSON object (status/total_results/
# search_result keys, see below) — was declared list[Dict], which
# never matched `return data` here or callers reading it as a dict.
def launch(self, params: Dict[str, str] = {}) -> Dict[str, Any]:
last_exception: Optional[Exception] = None
for attempt in range(self.MAX_RETRIES):
try:
resp = requests.get(
self.whoxy_api_endoint,
params=params,
timeout=10,
)
if resp.status_code == 429:
delay = self.INITIAL_DELAY * (2**attempt)
time.sleep(delay)
continue
resp.raise_for_status()
data: Dict[str, Any] = resp.json()
if data.get("status") != 1:
raise RuntimeError(
f"Error querying Whoxy API: {str(data.get('status_reason'))}"
)
if data.get("total_results") == 0:
raise ValueError("No match found for Whoxy search.")
return data
except requests.exceptions.HTTPError as e:
if resp.status_code in (429, 502, 503, 504):
last_exception = e
delay = self.INITIAL_DELAY * (2**attempt)
time.sleep(delay)
continue
raise RuntimeError(f"{str(e)}")
except (ValueError, RuntimeError):
raise
except Exception as e:
last_exception = e
delay = self.INITIAL_DELAY * (2**attempt)
time.sleep(delay)
continue
raise RuntimeError(
f"Whoxy API failed after {self.MAX_RETRIES} retries: {str(last_exception)}"
)