Unified API gateway for the Socialmesh mesh radio platform. All backend services are accessible from this domain, serving the Flutter app, web portals, and third-party integrations.
This page. API gateway documentation and service directory.
Aggregated health check across all downstream services. Returns individual service statuses and overall gateway health.
map.socialmesh.app —
Global node map, real-time positions, network stats.
GET /api/nodes — List all known mesh nodesGET /api/node/:id — Get a specific nodeGET /api/stats — Network statisticsGET /map — Interactive node mapGET /health — Health check
sigil.socialmesh.app —
Node identity card storage and retrieval.
POST /api/sigil — Store a sigil card snapshotGET /api/sigil/:id — Retrieve a sigil by IDGET /health — Health check
aether.socialmesh.app —
Flight sharing, search, and statistics.
POST /api/flight — Share a flightGET /api/flight/:id — Get a shared flightGET /api/flights — Search and filter flightsGET /api/flights/stats — Aggregate statisticsGET /api/flights/airports — Unique airport codesGET /health — Health checkPublic-facing web portals for browsing content are hosted separately on Firebase Hosting. These portals consume the APIs above via client-side requests.
All GET endpoints across every service are public.
POST endpoints require an X-API-Key header
when the respective service has key authentication enabled. The
Socialmesh Flutter app includes the key automatically.
Each downstream service enforces its own per-IP rate limits.
Typical limits are 20 POSTs and 120 GETs per minute per IP.
When exceeded, the service returns 429 Too Many Requests.
All services allow cross-origin requests from
socialmesh.app,
aether.socialmesh.app,
map.socialmesh.app,
and localhost.