handler

Documentation

Index

• func Clients(c fiber.Ctx) error
• func Run(webFS fs.FS) *fiber.App
• func Stats(c fiber.Ctx) error
• func Status(c fiber.Ctx) error
• func Submit(c fiber.Ctx) error

Functions

func Clients

func Clients(c fiber.Ctx) error

Clients returns one page of the connected-client list as JSON.

Query parameters:

• page: 1-based page number (default 1, clamped to the last page)
• page_size: rows per page (default 20, max 500)
• sort: sort key (default "uptime"; unknown keys fall back to it)
• order: "asc" (default) or "desc"

The default order (uptime ascending, i.e. longest-connected first) is stable across refreshes: rows keep their position and new connections append at the end, instead of jumping around with Go's random map iteration order.

func Run

func Run(webFS fs.FS) *fiber.App

Run starts the HTTP server in a goroutine. webFS is the embedded web bundle.

func Stats

func Stats(c fiber.Ctx) error

Stats returns stats as JSON

func Status

func Status(c fiber.Ctx) error

Status returns status as JSON

func Submit

func Submit(c fiber.Ctx) error

Submit handles APRS-IS HTTP packet upload (POST).

The request body must be:

user CALL pass CODE vers SW VER\r\n
PACKET\r\n

with Content-Type "application/octet-stream". On success it returns 200 with body "ok\n"; injected packets receive a qAC construct.