New Feature
May 22, 2025โข340 words
๐จ alerts=on API Feature
Welcome to the most chaotic-yet-secure corner of your API universe โ the alerts=on feature.
Think of it as your own digital SOC analyst... who also happens to enjoy surprising you. ๐ฒ
๐ฏ What It Does
When you call:
api.php?alerts=on
...the system will magically pull a random alert from the alerts_log database and serve it fresh like a hot threat pancake. ๐ฅ
โ๏ธ Parameters You Can Use
| Parameter | What It Does | Example |
|---------------|------------------------------------------|-------------------------------------------|
| alerts=on | Enables the alert feed (random alert) | /api.php?alerts=on |
| max= | How many random alerts to return | /api.php?alerts=on&max=5 |
| type= | Filter alerts by type | /api.php?alerts=on&type=network |
| severity= | Filter alerts by severity | /api.php?alerts=on&severity=high |
| format= | Set output format (json, txt, etc.) | /api.php?alerts=on&format=markdown |
๐ฆ Output Formats
You can view alerts in 5 glorious flavors:
json(default): Machine-friendly, robot-approved ๐คtxt: Plain text for CLI or terminal gremlins ๐ฅ๏ธyaml: For the config wizards and devops druids ๐งโโ๏ธmarkdown: For people who write docs (hi there! ๐)html: If you're fancy and browsing in style ๐
๐งช Examples
Get 1 random alert:
GET /api.php?alerts=on
Get 3 random malware alerts in markdown:
GET /api.php?alerts=on&type=malware&max=3&format=markdown
Get a critical severity alert in plain text:
GET /api.php?alerts=on&severity=critical&format=txt
๐ง Fun Fact
Alerts are selected randomly every time โ so it's like a security-themed slot machine. ๐ฐ
Except every spin is an incident youโll have to triage. ๐
๐ก๏ธ Bonus Features
Combine
typeandseverityfilters to narrow down chaos.Use
types=listto see all alert types available. (Like ordering from a menu of doom.)
๐ฌ Final Words
With alerts=on, your system is now sending you handcrafted, artisanal alerts on-demand.
Whether youโre testing, training, or just a fan of cyber-chaos, youโre in for a treat. ๐ฟ
Stay safe, stay random!
๐ง ๐ป๐