Skip to main content

SSA Backend Overview

This documentation covers the complete SSA Backend application.

  • Authentication, authorization model, and token lifecycle
  • Satellite operations against the NORAD database and TLE-based computations
  • Advanced satellite analysis (pass analyzer, maneuver detection, async tasking)
  • Favorites and Groups management
  • News aggregation and analytics (TimescaleDB)
  • Whitelist features

Base URL assumptions:

  • API: http://<host>:${FASTAPI_PORT:-8005} via nginx on ${NGINX_HTTP_PORT:-85} if enabled
  • OpenAPI schema: GET /openapi.json
  • Swagger UI: GET /docs

Authentication:

  • JWT Bearer tokens required for endpoints marked as Auth required
  • Obtain via POST /auth/login and include header: Authorization: Bearer <access_token>

Conventions:

  • Timestamps are ISO-8601 UTC unless specified
  • Errors use FastAPI HTTPException patterns with appropriate status codes