Funzioni Avanzate
API REST specifiche per le operazioni di download, clipping e geoprocessing, per garantire l’interoperabilità dei dati
Per garantire l’interoperabilità della piattaforma, sono state implementate delle API basate sul paradigma REST.
Le funzioni possono essere invocate tramite chiamate HTTP di tipo GET o POST e i dati verranno rilasciati in vari formati che seguono standard approvati da OGC.
Per utilizzare le API è possibile impiegare software quali cURL o Postman, oppure implementare le chiamate ai servizi del DO all’interno del proprio framework di sviluppo (C, Java, Python, ecc.).
Tipologia di immagini
Le funzioni messe a disposizione lavorano su dataset, sia originali che derivati, archiviati nel database centrale del Drought Central. Qui i prodotti utilizzabili con le API e il relativo tag da utilizzare nelle chiamate.
PRODOTTO | TAG |
Standardized Precipitation Index – 1 month (SPI1) | spi1 |
Standardized Precipitation Index – 3 month (SPI3) | spi3 |
Standardized Precipitation Index – 6 month (SPI6) | spi6 |
Standardized Precipitation Index – 12 month (SPI12) | spi12 |
Standardized Precipitation Index – 24 month (SPI24) | spi24 |
Skin Temperature Anomalies | skintemp_anomalies |
"Access token" e "Refresh token"
Tutte le chiamate devono essere effettuate passando nell’header un Access token.
L’utilizzo dell’ACCESS TOKEN ha una validità di 10 minuti, al termine dei quali dovrà essere riaggiornato tramite il REFRESH TOKEN.
La prima volta che si vuole effettuare la chiamata o nel caso in cui i token siano scaduti, occorre invocare il servizio di autenticazione user, come riportato di seguito.
Generazione dei token
Tipo di chiamata: POST
url : https://dows.ibe.cnr.it:8443/dows-2-0/api/authentication/user
Funzione da chiamare per poter generare un access e un refresh token validi per l’utenza attiva:
- Parametro: (descrizione del parametro)
- Username: mail dell’utente
- Pssword: password
I parametri si passano come entity alla chiamata (FORM URLENCODED). Questa funzione genererà un nuovo Access token e un nuovo Refresh token.
Il nuovo Access token avrà una validità di 10 minuti, al termine dei quali dovrà essere rigenerato con una nuova chiamata (vedi sotto), mentre il suo tempo di Refresh sarà di 20 giorni, al termine del quale scadrà la sessione e sarà necessario richiamare il servizio user per rigenerare entrambi i token.
In caso di autenticazione eseguita con successo, verrà restituito un JSON contenente i due token. Il JSON sarà così strutturato:
- Oggetto (significato)
- access_token
- refresh_token
Nel caso di un’autenticazione fallita, verrà restituito il messaggio “Unauthorized”.
Esempio di chiamata:
curl -X POST –data ‘username=nome.cognome@xxx.it‘ –data ‘password=XXXXXX’ -H ‘Content-
Type: application/x-www-form-urlencoded’ https://agrosatws.ibe.cnr.it:8443/dows-2.0/api/authentication/user
