Gli endpoint pubblici del catalogo sono ora disponibili

Il 19 aprile 2026, abbiamo reso pubblico il catalogo GribStream.

Finora, l'API pubblica era concentrata soprattutto sul recupero dei dati da /timeseries e /runs. Avevamo anche alcune funzioni di supporto per i metadati, pensate principalmente per le dashboard interne, ma non erano un'interfaccia su cui volevamo che i clienti costruissero nel lungo periodo.

Questo rilascio cambia la situazione.

Cosa è disponibile ora

• GET /api/v2/catalog/datasets elenca i dataset insieme a metadati pubblici come fornitore, cadenza, copertura archivio, tag, link alle fonti e link alle pagine dei modelli.
• GET /api/v2/catalog/datasets/{dataset}/parameters elenca i parametri disponibili per un dataset.
• GET /api/v2/catalog/datasets/{dataset}/parameters/{parameter} restituisce il dettaglio completo per un codice parametro esatto, incluse le variazioni di selettore.
• GET /api/v2/catalog/shared-parameters e GET /api/v2/catalog/shared-parameters/{parameter} espongono un livello curato tra dataset per applicazioni che vogliono mappare un segnale logico su più modelli.

Un dettaglio importante: gli short name dei parametri, cioè i nomi brevi usati nei file, vengono restituiti con il maiuscolo/minuscolo esatto della fonte originale. Se un dataset espone 100u, il catalogo restituisce 100u, ed è quello il valore da riusare nelle richieste di previsione.

Chi dovrebbe usarlo

Se sai già di volere qualcosa come GFS TMP su 2 m above ground, non cambia nulla. Il percorso più semplice resta chiamare direttamente l'endpoint di accesso ai dati. La guida rapida continua a partire da lì.

Il catalogo è più utile quando stai costruendo:

• un selettore di dataset o parametri
• una dashboard multi-modello
• strumenti interni
• client o SDK generati
• un'applicazione che deve scoprire selettori invece di scriverli direttamente nel codice

Abbiamo aggiunto una sezione avanzata sul catalogo alla guida rapida per quel workflow, dopo gli esempi normali di richieste di dati.

Perché volevamo averlo pronto

Stiamo per rendere questi endpoint parte dell'interfaccia pubblica stabile, quindi era importante costruire una base solida ora invece di continuare a estendere vecchie funzioni di supporto ai metadati ad hoc.

Questo dovrebbe rendere molto più semplice costruire integrazioni su GribStream, sia che tu stia collegando la tua applicazione, esplorando dataset come NBM o IFS Operational, o generando integrazioni dalla specifica OpenAPI.

Ci dà anche una base più pulita per il passaggio successivo: usare questo catalogo per costruire documentazione MCP e skill, così gli strumenti IA possono scoprire come interrogare GribStream correttamente invece di affidarsi a tentativi ed errori.

Link

• Guida rapida
• Endpoint
• UI OpenAPI
• Specifica OpenAPI
• Modelli