{"ok":true,"data":{"servicio":"Visores Territoriales — API v1 (Visión Región 2.0)","version":"1.0.0","convenio":"NPA-045-2026 · Componente 3","descripcion":"API pública de datos abiertos de los cinco Visores de Apoyo. Lo de solo lectura funciona sin API key (límite por IP); los datasets internos y la gestión programática exigen sesión del panel o una key vr_live_* con el scope.","documentacion":"https://visores.visionregion.com.co/api/v1/capabilities · docs/API.md del repositorio","contacto":"info@visionregion.com.co","auth":{"publico":"Sin credenciales para health, capabilities, visores, panorama, export y datasets públicos.","api_key":"Header X-API-Key: vr_live_… (o Authorization: Bearer vr_live_…).","sesion":"La sesión del panel /gestion también autoriza los recursos internos."},"scopes":{"read":"Consultar el propio uso de la key.","export":"Descargas masivas de export (streaming CSV/JSON).","interno":"Datasets marcados como internos (insumos técnicos).","manage":"Cargas programáticas de datos (fase 2)."},"formatos":["json","csv"],"limites":{"rate":{"api":"Bucket general de la API (por IP o por key).","datos":"Bucket del gateway de datos.","carga":"Bucket de cargas (más estricto)."},"panorama_per_page_max":2000,"export_limite_filas":200000,"csv_conversion_max_bytes":31457280},"endpoints":[{"metodo":"GET","ruta":"/api/v1/health","auth":"público","descripcion":"Salud del servicio y estado de la base de datos."},{"metodo":"GET","ruta":"/api/v1/capabilities","auth":"público","descripcion":"Esta autodescripción de la API."},{"metodo":"GET","ruta":"/api/v1/usage","auth":"key(read) o sesión","descripcion":"Consumo y cuota de la API key."},{"metodo":"GET","ruta":"/api/v1/visores","auth":"público","descripcion":"Lista de los cinco visores publicados."},{"metodo":"GET","ruta":"/api/v1/visores/{slug}","auth":"público","descripcion":"Ficha de un visor con sus vigencias disponibles."},{"metodo":"GET","ruta":"/api/v1/visores/{slug}/datasets","auth":"público (internos: key(interno) o sesión)","descripcion":"Datasets del visor."},{"metodo":"GET","ruta":"/api/v1/datasets/{id}","auth":"según visibilidad","descripcion":"Sirve el artefacto del dataset (json passthrough o ?formato=csv)."},{"metodo":"GET","ruta":"/api/v1/panorama/{slug}","auth":"público","descripcion":"Consulta tabular del panorama con filtros (ano, dep, indicador, municipio) y paginación."},{"metodo":"GET","ruta":"/api/v1/export/panorama/{slug}.{csv|json}","auth":"público","descripcion":"Descarga masiva del panorama para Power BI/Tableau/Excel."},{"metodo":"POST","ruta":"/api/v1/cargas","auth":"key(manage)","descripcion":"Carga programática (fase 2; use el panel /gestion)."}],"mcp":{"paquete":"vision-region-visores-mcp","instalacion":"npx vision-region-visores-mcp  ·  claude mcp add visores -- npx vision-region-visores-mcp","transportes":["stdio (default)","streamable-http (MCP_HTTP=1, 127.0.0.1:3030)"]}}}