Blog GribStream
Les endpoints publics du catalogue sont maintenant disponibles
GribStream expose maintenant des endpoints publics de catalogue pour lister les datasets, inspecter les métadonnées des paramètres et résoudre des sélecteurs partagés entre datasets.
Le 19 avril 2026, nous avons rendu le catalogue GribStream public.
Jusqu'ici, l'API publique servait surtout à obtenir des données avec /timeseries et /runs. Nous avions aussi quelques outils auxiliaires de métadonnées, principalement pour alimenter les tableaux de bord, mais ce n'était pas une surface sur laquelle nous voulions encourager les clients à construire à long terme.
Cette sortie change cela.
Ce qui est maintenant disponible
GET /api/v2/catalog/datasetsliste les datasets avec leurs métadonnées publiques : fournisseur, cadence, couverture d'archive, tags, liens source et liens vers les pages modèle.GET /api/v2/catalog/datasets/{dataset}/parametersliste les paramètres disponibles pour un dataset.GET /api/v2/catalog/datasets/{dataset}/parameters/{parameter}retourne le détail complet d'un code de paramètre exact, y compris les variations de sélecteur.GET /api/v2/catalog/shared-parametersetGET /api/v2/catalog/shared-parameters/{parameter}exposent une couche organisée entre datasets pour les applications qui veulent mapper un signal logique sur plusieurs modèles.
Un détail important : les short names des paramètres sont retournés avec la casse exacte du fournisseur. Si un dataset expose 100u, le catalogue retourne 100u, et c'est la valeur à réutiliser dans les requêtes de prévision.
Qui devrait l'utiliser
Si vous savez déjà que vous voulez quelque chose comme GFS TMP à 2 m above ground, rien ne change. Le chemin le plus simple reste d'appeler directement l'Endpoint de données. Le Démarrage rapide continue de commencer par là.
Le catalogue devient plus utile lorsque vous construisez :
- un sélecteur de dataset ou de paramètre
- un tableau de bord multi-modèles
- des outils internes
- des clients générés ou des fonctions SDK auxiliaires
- une application qui doit découvrir les sélecteurs au lieu de les écrire en dur
Une section avancée sur le catalogue est maintenant disponible dans le Démarrage rapide pour ce parcours, après les exemples classiques de requêtes de données.
Pourquoi nous voulions cette base
Nous sommes sur le point de faire de ces endpoints une partie stable de la surface publique. Il était donc important d'avoir une base propre maintenant, plutôt que de continuer à étendre les anciens outils auxiliaires de métadonnées ad hoc.
Cela devrait rendre GribStream beaucoup plus simple à intégrer, que vous branchiez votre propre application, exploriez des datasets comme NBM ou IFS Operational, ou génériez des intégrations depuis la spécification OpenAPI.
Cela nous donne aussi une meilleure base pour l'étape suivante : utiliser ce catalogue afin de construire la documentation MCP et les skills, pour que les outils d'IA découvrent comment interroger GribStream correctement au lieu de procéder par essais et erreurs.
