Astra API Reference
The high-performance backend serving the Astra Client. Handling real-time authentication, player states, telemetry, and cosmetic distribution.
Player State & Status
POST
/status/login
Register client session & generate AstraToken
POST
/status/logout
Terminate client session
Profiles & Cosmetics
GET
/profile/:uuid
Fetch player cosmetics by UUID
GET
/profile/name/:username
Fetch player cosmetics by username
GET
/cosmetics
Get authenticated player's cosmetics (Requires Bearer Auth)
POST
/cosmetics/redeem-discord
Redeem Discord link reward cape
Featured Servers
GET
/servers/featured
List active featured network IPs
Telemetry & Logs
POST
/api/logs/upload
Upload client crash reports & system specs
GET
/api/logs/recent
Fetch recent logs (Requires Admin Secret)
Astra-Share
POST
/api/v1/share/create
Generate a 6-digit sync code for a modpack manifest
GET
/api/v1/share/:code
Retrieve a modpack manifest using a sync code
System
GET
/health
Check API uptime and response latency