Galactic Tournament’s Angular frontend communicates exclusively with a single Spring Boot backend over HTTP. Every service usesDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/HectorDNC/galactic-tournament-front/llms.txt
Use this file to discover all available pages before exploring further.
environment.api_url as the base URL, so the correct backend is targeted automatically depending on the active build configuration. This page documents every endpoint the frontend calls, the TypeScript interfaces that model their payloads, and ready-to-run curl examples.
The production backend is deployed on Railway at
https://galactic-tournament-app-production.up.railway.app. All example URLs on this page use that base. For local development, substitute http://localhost:8080.TypeScript Interfaces
The following interfaces are defined in the project’s model files and are used as generic type arguments for Angular’sHttpClient responses throughout the services.
Endpoints
- Species
- Battles
- Statistics
- Dashboard
GET /api/species/all
Returns the complete, unpaginated list of all species. Used by the battle form to populate fighter dropdowns.GET {api_url}/api/species/allNo request parameters.Response — Specie[]Unique identifier for the species.
Display name of the species (e.g.
"Zorgon").Numeric combat power rating used to determine battle outcomes.
Text description of the species’ unique ability.
ISO 8601 timestamp recording when the species was registered.
GET /api/species
Returns a paginated, optionally filtered list of species. Used by the species management table.GET {api_url}/api/species?page=0&size=10&name=zorgQuery ParametersZero-based page index.
Number of records per page.
Optional partial-match filter on the species name. Omit to return all species for the requested page.
Page<Specie>Array of species objects for the current page. Each element has the same shape as the
/api/species/all response items.GET /api/species/:id
Fetches a single species by its numeric ID.GET {api_url}/api/species/{id}Path ParametersThe unique identifier of the species to retrieve.
SpecieReturns a single Specie object. See GET /api/species/all for field descriptions.POST /api/species
Creates a new species entry.POST {api_url}/api/speciesRequest Body — SpecieRequestName of the new species. Must be unique.
Numeric power rating. Higher values give an advantage in battles.
Description of the species’ special combat ability.
SpecieReturns the newly created Specie object, including the server-assigned id and createdAt timestamp.PUT /api/species/:id
Updates an existing species by ID. The entireSpecieRequest body must be provided (full replacement, not a partial patch).PUT {api_url}/api/species/{id}Path ParametersThe unique identifier of the species to update.
SpecieRequestUpdated species name.
Updated power level.
Updated special ability description.
SpecieReturns the updated Specie object.curl Examples
Endpoint Summary
| Method | Path | Service | Description |
|---|---|---|---|
GET | /api/species/all | SpeciesService.getAll() | All species, unpaginated |
GET | /api/species | SpeciesService.findAll() | Paginated + filterable species list |
GET | /api/species/:id | SpeciesService.findById() | Single species by ID |
POST | /api/species | SpeciesService.create() | Create a new species |
PUT | /api/species/:id | SpeciesService.update() | Update an existing species |
POST | /api/battles | BattleService.start() | Start a battle between two species |
POST | /api/battles/random | BattleService.randomBattle() | Start a battle with random fighters |
GET | /api/battle-statistics/ranking | BattleStatisticsService.getRanking() | Victory leaderboard |
GET | /api/dashboard | DashboardService.getDashboard() | Aggregated dashboard summary |