Conectar con la API

Esta pantalla forma parte del frontend oficial en Next y centraliza el acceso autenticado a la API.

Ask Agent para integraciones

Pregunta cómo integrar la API en tu app y obtendrás una respuesta operativa, con endpoints, headers y ejemplos listos para copiar y pegar.

Ejemplo: Cómo puedo usar esta API para alimentar mi app de datos abiertos sobre Madrid

Base URL que usará en los ejemplos: https://open-data-api-498564485804.us-central1.run.app

Acceso de usuario

Cargando sesión...

Datos de conexión

Base URL API

https://open-data-api-498564485804.us-central1.run.app

Headers auth

Authorization: Bearer <id_token> o X-API-Key: <tu_api_key>

Interfaz visual

La UI web no es la API; usa la base URL de arriba.

Cómo conectarlo

Desde la UI usa tu sesión autenticada.
Para integraciones externas crea una API key propia.
Usa Authorization: Bearer ... o X-API-Key según el caso.
Empieza probando /search/unified o /health.

Ejemplo rápido

curl -H "X-API-Key: <tu_api_key>" \
  "https://open-data-api-498564485804.us-central1.run.app/search/unified?q=calidad+del+aire+madrid&limit_per_source=5"

curl -X POST "https://open-data-api-498564485804.us-central1.run.app/agent/ask" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <tu_api_key>" \
  --data '{"question":"como ha evolucionado la calidad del aire en Madrid"}'

Endpoints principales

Método	Endpoint	Descripción	Auth
`GET`	`/health`	Health check	No
`GET`	`/sources`	Lista de fuentes disponibles	Público
`GET`	`/search/unified?q=calidad+del+aire+madrid&limit_per_source=5`	Búsqueda unificada	Bearer o API key
`GET`	`/timeseries?source=worldbank&indicator_id=SP.POP.TOTL&country_codes=ESP&start_year=2018&end_year=2023`	Serie temporal	Bearer o API key
`POST`	`/agent/api-helper`	Guía de integración de la API	Bearer o API key
`POST`	`/agent/plan`	Planifica una pregunta analítica	Bearer o API key
`POST`	`/agent/ask`	Respuesta analítica completa	Bearer o API key

Nota operativa

La UI autenticada usa sesión de usuario para ejecutar consultas. Las integraciones externas siguen usando API keys.