Construyendo sobre TroncoCorp: guía para desarrolladores

El ecosistema TroncoCorp no es solo un conjunto de proyectos: es una infraestructura digital soberana diseñada para que cualquiera pueda construir sobre ella. Este artículo es tu guía de inicio.

Por qué construir sobre TroncoCorp

TroncoCorp ofrece algo que pocos ecosistemas tecnológicos pueden reclamar: independencia total. No dependemos de Big Tech, no tenemos vendor lock-in, y nuestras APIs son públicas, gratuitas y sin autenticación.

Lo que obtienes como desarrollador:

• Datos estructurados — Cada entidad del ecosistema (TripX, Zénit, Parlamento Digital, etc.) expone información consistente en JSON.
• Sin API keys — Cero fricción. Haz una petición y obtén una respuesta.
• CORS abierto — Puedes consumir la API directamente desde el navegador.
• 99.9%+ uptime — Infraestructura sobre 247 nodos Zénit con latencia media de 12ms.
• SDKs en 3 lenguajes — JavaScript, Python y curl. Cada uno con la misma interfaz.

Empezar en 5 minutos

1. Haz tu primera petición

Abre una terminal y ejecuta:

curl -s https://troncocorp.es/api/ecosystem | jq '.entities[].name'

Deberías ver algo como:

"TroncoCorp"
"Obras"
"Films"
"Parlamento Digital"
"TripX"
"TripX Rider"
"TripX Central"
"TripX Driver"
"Zénit"
"MadridTaxis"
"Vértice Zeta"
"M.C.C.R."
"Sociedad"
"Automatización"
"Andrés Ares"

2. Prueba el health check

curl -s https://troncocorp.es/api/status | jq '.summary'

Respuesta típica:

{
  "total": 3,
  "online": 3,
  "offline": 0,
  "allOperational": true
}

3. Usa el SDK JavaScript

Incluye el SDK en tu página HTML:

<script src="https://troncocorp.es/sdk/troncocorp-sdk.min.js"></script>
<script>
  const sdk = new TroncoCorpSDK();
  const eco = await sdk.getEcosystem();
  console.log(`Hay ${eco.entities.length} entidades en el ecosistema`);
</script>

También funciona en Node.js:

npm install -S troncocorp-sdk
# o simplemente copia el archivo

import { TroncoCorpSDK } from 'troncocorp-sdk';
const sdk = new TroncoCorpSDK();
const status = await sdk.getStatus();
console.log(status.summary.allOperational ? 'Todo OK' : 'Revisa /status');

4. SDK Python

from troncocorp import TroncoCorpSDK

sdk = TroncoCorpSDK()
eco = sdk.get_ecosystem()
for entity in eco["entities"]:
    print(f"{entity['name']:20s} {entity['status']:12s} {entity['type']}")

Requiere requests. Instala con pip install requests.

API Reference

GET /api/ecosystem

Devuelve la fotografía completa del ecosistema. El objeto raíz contiene:

Campo	Tipo	Descripción
ecosystem	objeto	Metadatos del ecosistema (nombre, lema, fundación)
entities	array	Lista de todas las entidades activas
divisions	array	Divisiones que agrupan entidades por tipo
timeline	array	Línea de tiempo histórica y futura hasta 2097
metrics	objeto	Datos de crecimiento, capitalización, usuarios y transacciones
_meta	objeto	Metadatos de la respuesta (versión, timestamp)

Cada entidad tiene esta estructura:

interface Entity {
  id: string;          // "zenit", "tripx", etc.
  name: string;        // Nombre público
  type: "matriz" | "contenido" | "infraestructura" | "gobernanza" | "movilidad";
  year: number;        // Año de fundación
  status: "activo" | "beta" | "produccion";
  parent: string | null;
  description: string;
  url: string;
  leader: string;
  teamSize: number;
  color: string;
  children: string[];
}

GET /api/status

Health check en tiempo real. Verifica la disponibilidad de:

• troncocorp.es — Web principal
• madridtaxis.es — Operador de taxi real
• tripx.es — Plataforma de movilidad

Cada site reporta:

interface SiteStatus {
  name: string;
  url: string;
  status: "online" | "offline";
  statusCode: number | null;
  latencyMs: number | null;
  lastChecked: string;    // ISO 8601
}

Casos de uso

Dashboard de monitoreo

Usa getStatus() como fuente para tu propio dashboard de uptime. Llámalo cada 60 segundos (el endpoint soporta Cache-Control: max-age=60).

Visualización del ecosistema

El mapa interactivo de /ecosistema se construye enteramente con datos de getEcosystem(). Puedes hacer lo mismo: las coordenadas no están en la API, pero los nombres, tipos y relaciones sí.

Aplicaciones de movilidad

TripX expone información sobre sus tres apps (Rider, Central, Driver). Puedes construir herramientas complementarias — por ejemplo, un visor de rutas o un panel de estadísticas.

Buenas prácticas

1. Cachea las respuestas — /api/ecosystem cambia con poca frecuencia. Un cache de 1 hora es seguro.
2. Usa el SDK — Te ahorra manejar fetch, errores HTTP y parseo JSON.
3. Respeta el rate limit implícito — No hay límite duro, pero seas razonable. 10 peticiones/minuto es más que suficiente para cualquier caso de uso.
4. Reporta bugs — Si encuentras algo raro, abre un issue en GitHub.

Próximos pasos

• Explora la documentación completa de la API
• Descarga el SDK JavaScript o Python
• Prueba el ejemplo interactivo
• Visita la página de estado del ecosistema
• Únete a la Sociedad para participar en las decisiones

---

TroncoCorp — Existir sin permiso. Construir sin pedirlo.