Blog de GribStream
Los endpoints públicos de catálogo ya están disponibles
GribStream ahora expone endpoints públicos de catálogo para listar datasets, inspeccionar metadatos de parámetros y resolver selectores compartidos entre datasets.
El 19 de abril de 2026, hicimos público el catálogo de GribStream.
Hasta ahora, la API pública estaba enfocada principalmente en obtener datos desde /timeseries y /runs. También teníamos algunas funciones auxiliares de metadatos pensadas sobre todo para alimentar paneles, pero no eran algo sobre lo que quisiéramos que los clientes construyeran a largo plazo.
Esta publicación cambia eso.
Qué está disponible ahora
GET /api/v2/catalog/datasetslista datasets junto con metadatos públicos como proveedor, cadencia, cobertura de archivo, tags, enlaces de origen y enlaces a páginas de modelos.GET /api/v2/catalog/datasets/{dataset}/parameterslista los parámetros disponibles para un dataset.GET /api/v2/catalog/datasets/{dataset}/parameters/{parameter}devuelve el detalle completo de un código exacto de parámetro, incluidas sus variaciones de selector.GET /api/v2/catalog/shared-parametersyGET /api/v2/catalog/shared-parameters/{parameter}exponen una capa curada entre datasets para aplicaciones que quieren mapear una señal lógica a través de varios modelos.
Un detalle importante: los nombres cortos de parámetros se devuelven con las mayúsculas y minúsculas exactas de la fuente original. Si un dataset expone 100u, el catálogo devuelve 100u, y ese es el valor que debe reutilizarse en consultas de pronóstico.
Quién debería usarlo
Si ya sabes que quieres algo como GFS TMP en 2 m above ground, nada cambia. La ruta más simple sigue siendo llamar directamente al endpoint de datos. La guía de inicio rápido sigue empezando por ahí.
El catálogo es más útil cuando estás construyendo:
- un selector de datasets o parámetros
- un panel multi-modelo
- herramientas internas
- clientes generados o funciones auxiliares de SDK
- una aplicación que necesita descubrir selectores en lugar de hardcodearlos en el código
Agregué una sección avanzada de catálogo a la guía de inicio rápido para ese workflow, después de los ejemplos normales de consulta de datos.
Por qué queríamos tener esto listo
Estamos por convertir estos endpoints en parte de la superficie pública estable, así que era importante dejar una base sólida ahora en lugar de seguir extendiendo las funciones auxiliares de metadatos anteriores.
Esto debería hacer mucho más fácil construir sobre GribStream, ya sea que estés conectando tu propia aplicación, explorando datasets como NBM o IFS Operational, o generando integraciones a partir de la especificación OpenAPI.
También nos da una base más limpia para el próximo paso: usar este catálogo para construir documentación MCP y skills para que las herramientas de IA puedan descubrir cómo consultar GribStream correctamente, en lugar de depender de prueba y error.