Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/No-Country-simulation/G9-LATAM-Team-58/llms.txt

Use this file to discover all available pages before exploring further.

The /stats endpoint gives you a real-time snapshot of the Mindloom content corpus. It returns the total number of indexed items, a per-category breakdown (only categories with at least one item are included), and a count of items added in the last seven days. This makes it the primary data source for populating dashboard summary cards, category distribution charts, and activity indicators across the web client.

Endpoint

GET /stats
Base URL: http://localhost:8080
Auth: None required
Query parameters: None

Response — 200 OK

A successful request returns a StatsResponse object.
total
number
required
Total number of content items currently indexed in the corpus.
byCategory
object
required
A map of category name → item count. Only categories with at least one item appear in this object. Categories with zero items are omitted entirely.
addedThisWeek
number
required
Number of content items added in the last 7 days.
byCategory does not include categories with zero items. If a category key is absent from the map, its count is 0. Client code should default missing keys to zero rather than treating their absence as an error.

Example

Request

curl http://localhost:8080/stats

Response

{
  "total": 1420,
  "byCategory": {
    "Backend": 312,
    "Frontend": 198,
    "Datos e IA": 241,
    "Bases de datos": 187,
    "DevOps y Cloud": 156,
    "Seguridad": 89,
    "Móvil": 112,
    "Fundamentos": 125
  },
  "addedThisWeek": 14
}

Error Codes

HTTP Statuserror codeDescription
503INTERNAL_ERRORThe database is not configured. The API was started without app.database.enabled=true (scaffold mode). Enable the db Spring profile or set the property, then restart.

503 error response

{
  "error": "INTERNAL_ERROR",
  "message": "Base de datos no configurada. Use app.database.enabled=true"
}

Build docs developers (and LLMs) love