Öffentliche Katalog-Endpoints sind jetzt verfügbar

Am 19. April 2026 haben wir den GribStream-Katalog öffentlich gemacht.

Bis jetzt ging es in der öffentlichen API vor allem darum, Daten über /timeseries und /runs abzurufen. Es gab außerdem einige Metadaten-Hilfen, die hauptsächlich interne Dashboards unterstützten, aber sie waren nicht als stabile Grundlage gedacht, auf der Kunden langfristig bauen sollten.

Diese Veröffentlichung ändert das.

Was jetzt verfügbar ist

• GET /api/v2/catalog/datasets listet Datasets mit öffentlichen Metadaten wie Anbieter, Kadenz, Archivabdeckung, Tags, Quell-Links und Links zu Modellseiten.
• GET /api/v2/catalog/datasets/{dataset}/parameters listet die Parameter, die für ein Dataset verfügbar sind.
• GET /api/v2/catalog/datasets/{dataset}/parameters/{parameter} gibt die vollständigen Details zu einem exakten Parametercode zurück, einschließlich Selector-Varianten.
• GET /api/v2/catalog/shared-parameters und GET /api/v2/catalog/shared-parameters/{parameter} stellen eine kuratierte Ebene über mehrere Datasets hinweg bereit, für Anwendungen, die ein logisches Signal auf mehrere Modelle abbilden möchten.

Ein Detail ist besonders wichtig: Parameter-Kurznamen werden in der exakten Groß- und Kleinschreibung der ursprünglichen Quelle zurückgegeben. Wenn ein Dataset 100u bereitstellt, gibt der Katalog 100u zurück, und genau dieser Wert sollte in Vorhersage-Requests wiederverwendet werden.

Wer das nutzen sollte

Wenn Sie bereits wissen, dass Sie etwa GFS TMP auf 2 m above ground brauchen, ändert sich nichts. Der einfachste Weg ist weiterhin, den Daten-Endpoint direkt aufzurufen. Der Quickstart beginnt weiterhin genau dort.

Der Katalog ist besonders nützlich, wenn Sie Folgendes bauen:

• einen Dataset- oder Parameter-Picker
• ein Dashboard über mehrere Modelle
• interne Tools
• generierte Clients oder SDK-Hilfen
• eine Anwendung, die Selektoren entdecken muss, statt sie fest im Code zu codieren

Für diesen Workflow haben wir dem Quickstart einen erweiterten Katalogabschnitt hinzugefügt, nach den normalen Beispielen für Datenabfragen.

Warum wir das jetzt veröffentlichen wollten

Diese Endpoints sollen Teil der stabilen öffentlichen Oberfläche werden. Deshalb war es wichtig, jetzt eine saubere Grundlage zu schaffen, statt die früheren Ad-hoc-Metadaten-Hilfen weiter auszubauen.

Damit sollte es deutlich einfacher werden, auf GribStream aufzubauen: egal ob Sie eine eigene Anwendung verdrahten, Datasets wie NBM oder IFS Operational erkunden oder Integrationen aus der OpenAPI-Spezifikation generieren.

Der Katalog gibt uns außerdem eine sauberere Basis für den nächsten Schritt: MCP- und Skill-Dokumentation, mit der KI-Tools lernen können, GribStream korrekt abzufragen, statt sich durch Ausprobieren an gültige Requests heranzutasten.

Links

• Quickstart
• Endpoints
• OpenAPI UI
• OpenAPI-Spezifikation
• Modelle