DEV

API Reference

Documentación de la API

Base URL: https://troncocorp.es

La API es pública y gratuita. No requiere autenticación. CORS habilitado para todos los orígenes.

GET /api/ecosystem

Obtener el ecosistema completo

Devuelve toda la información del ecosistema TroncoCorp: entidades, divisiones, línea de tiempo, métricas de crecimiento, capitalización y datos de usuarios activos.

Parámetros

Nombre Tipo Requerido Descripción
ninguno - - Este endpoint no requiere parámetros.

Schema de respuesta

Response - application/json 
{
  "ecosystem": {
    "name": "TroncoCorp",
    "slogan": "Existir sin permiso",
    "founded": 2025,
    "totalEntities": 11,
    "totalEmployees": 247,
    "countries": 1,
    "description": "Ecosistema digital soberano..."
  },
  "entities": [
    {
      "id": "troncocorp",
      "name": "TroncoCorp",
      "type": "matriz",
      "year": 2025,
      "status": "activo",
      "description": "...",
      "url": "/",
      "teamSize": 1,
      "color": "#0f0",
      "children": []
    }
  ],
  "divisions": [...],
  "timeline": [...],
  "metrics": {
    "growthByYear": [...],
    "capitalization": [...],
    "activeUsers": [...],
    "transactions": [...]
  },
  "_meta": {
    "generated": "2026-05-20T...",
    "version": "1.0"
  }
}

Ejemplos

# Obtener todo el ecosistema
curl -s https://troncocorp.es/api/ecosystem

# Con jq para filtrar solo nombres
curl -s https://troncocorp.es/api/ecosystem | jq '.entities[].name'

# Entidades activas
curl -s https://troncocorp.es/api/ecosystem | jq '.entities[] | select(.status == "activo") | {name, type}'

Códigos de error

Código Significado
200 Éxito. Respuesta JSON completa.
404 Endpoint no encontrado. Verifica la URL.
500 Error interno del servidor. Consulta /status.
GET /api/status

Estado del sistema

Health check en tiempo real. Verifica la disponibilidad de los sitios del ecosistema TroncoCorp, midiendo latencia y código de estado HTTP para cada uno.

Parámetros

Nombre Tipo Requerido Descripción
ninguno - - No requiere parámetros.

Schema de respuesta

Response - application/json 
{
  "ecosystem": "TroncoCorp",
  "generatedAt": "2026-05-20T12:00:00.000Z",
  "summary": {
    "total": 3,
    "online": 3,
    "offline": 0,
    "allOperational": true
  },
  "sites": [
    {
      "name": "TroncoCorp",
      "url": "https://troncocorp.es",
      "status": "online",
      "statusCode": 200,
      "latencyMs": 45,
      "lastChecked": "2026-05-20T12:00:00.000Z"
    }
  ]
}

Ejemplos

# Health check rapido
curl -s https://troncocorp.es/api/status

# Ver solo el resumen
curl -s https://troncocorp.es/api/status | jq '.summary'

# Saber si todo esta operativo
curl -s https://troncocorp.es/api/status | jq '.summary.allOperational'

Códigos de error

Código Significado
200 Éxito. Los sites individuales pueden reportar offline.
408 Timeout al verificar un site (10s). El site aparece como offline.
500 Error interno del health checker.

Tipos comunes

Entity

{
  id:          string
  name:        string
  type:        "matriz" | "contenido" | "infraestructura" | "gobernanza" | "movilidad"
  year:        number
  status:      "activo" | "beta" | "produccion"
  parent:      string | null
  description: string
  url:         string
  leader:      string
  teamSize:    number
  color:       string
  children:    string[]
}

Division

{
  id:        string
  name:      string
  color:     string
  entities:  string[]
}

Manejo de errores

La API usa códigos de estado HTTP convencionales. En caso de error, el cuerpo de la respuesta contiene un mensaje descriptivo.

Código Descripción
200 OK. La petición se completó correctamente.
404 Endpoint no encontrado. Verifica que la URL sea correcta.
408 Timeout. El servidor tardó más de 10s en responder.
500 Error interno. Intenta de nuevo o consulta /status.

SDK JavaScript

El SDK vanilla JS está disponible en el CDN del proyecto. Sin dependencias. 

<!-- CDN -->
<script src="https://troncocorp.es/sdk/troncocorp-sdk.min.js"></script>

// O descarga directa:
// https://troncocorp.es/sdk/troncocorp-sdk.js
// https://troncocorp.es/sdk/troncocorp.py
EN