Skip to content

REST API ​

Base URL: http://<server>:8080/api. Responses are JSON unless stated otherwise. Send Authorization: Bearer <token> after login. Roles are admin and operator.

Authentication ​

MethodPathAccessNotes
POST/auth/loginPublic{username, password} returns token and user
GET/auth/meAny userCurrent user
POST/auth/change-passwordAny userPassword must be at least 8 characters

Devices ​

MethodPathAccess
GET / POST/devicesAny / Admin
PUT / DELETE/devices/:idAdmin
GET/devices/unknownAny user
DELETE/devices/unknown/:ipAdmin

Create a device with {name, ip_address, vendor} where vendor is netelastic or mikrotik.

Logs ​

All log endpoints require from and to timestamps. Optional filters are public_ip, public_port, event_type, inside_ip and username.

MethodPathNotes
GET/logs/searchPaginated results; max limit 1,000
GET/logs/export.csvCSV attachment; max 1,000,000 rows
GET/logs/export.pdfPDF attachment; max 5,000 rows

Every search and export is written to the audit log.

Dream Radius ISP CRM