Sviluppatori
Intelligenza irrigua, a una chiamata di distanza.
Le API di Agorà girano su Milky Data Way, la nostra piattaforma interoperabile per gemelli digitali. Invii un’unità e ottieni una previsione irrigua a 3 giorni con il bilancio idrico che la motiva. Invii un riscontro e l’IA calibra il modello su quell’unità.
Guida rapida
Registra un’unità, interrogala ogni mattina, raccontale com’è andata.
- 01
Registra l’unità
Invia le coordinate e la coltura. Agorà sceglie il miglior servizio meteo, i dati del suolo e il modello colturale più adatti a quella posizione.
- 02
Leggi la previsione
Ottieni il fabbisogno irriguo di oggi, domani e dopodomani, con il bilancio idrico completo.
- 03
Invia il riscontro
Comunica l’irrigazione realmente effettuata e ciò che gli utenti osservano. È da qui che impara l’IA di Agorà, così il modello continua ad adattarsi a ogni unità.
curl -X POST "$AGORA_API_URL/fields" \ -H "Authorization: Bearer $AGORA_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Campo nord – pomodori", "location": { "lat": 44.5027, "long": 11.37 }, "crop": "https://vaimee.com/criteria/crops/<crop-id>", "soil": { "name": "Loam over clay", "horizons": [ { "number": 1, "upperDepth": 0, "lowerDepth": 40, "sand": 40, "silt": 40, "clay": 20, "organicMatter": 1.5 }, { "number": 2, "upperDepth": 40, "lowerDepth": 100, "sand": 30, "silt": 40, "clay": 30 } ] }, "operatingMode": "AutomaticMode", "forecastDays": 3 }'
import os, requests payload = { "name": "Campo nord – pomodori", "location": {"lat": 44.5027, "long": 11.37}, "crop": "https://vaimee.com/criteria/crops/<crop-id>", "soil": { "name": "Loam over clay", "horizons": [ {"number": 1, "upperDepth": 0, "lowerDepth": 40, "sand": 40, "silt": 40, "clay": 20, "organicMatter": 1.5}, {"number": 2, "upperDepth": 40, "lowerDepth": 100, "sand": 30, "silt": 40, "clay": 30} ] }, "operatingMode": "AutomaticMode", "forecastDays": 3 } r = requests.post( f"{os.environ['AGORA_API_URL']}/fields", headers={"Authorization": f"Bearer {os.environ['AGORA_KEY']}"}, json=payload, ) print(r.json())
const payload = { name: "Campo nord – pomodori", location: { lat: 44.5027, long: 11.37 }, crop: "https://vaimee.com/criteria/crops/<crop-id>", soil: { name: "Loam over clay", horizons: [ { number: 1, upperDepth: 0, lowerDepth: 40, sand: 40, silt: 40, clay: 20, organicMatter: 1.5 }, { number: 2, upperDepth: 40, lowerDepth: 100, sand: 30, silt: 40, clay: 30 } ] }, operatingMode: "AutomaticMode", forecastDays: 3 }; const res = await fetch(`${process.env.AGORA_API_URL}/fields`, { method: "POST", headers: { Authorization: `Bearer ${process.env.AGORA_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify(payload) }); console.log(await res.json());
Imposta AGORA_API_URL con l’URL di base delle API e AGORA_KEY con il token di accesso. Sostituisci <crop-id> con un ID restituito da GET /crops.
Dentro Agorà Studio
Le API, operazione per operazione.
La documentazione OpenAPI raggruppa le operazioni disponibili per risorsa: campi, suoli e colture. Registrazione dei campi, irrigazioni, dati meteo e previsioni si consultano nello stesso posto.
-
La documentazione a colpo d’occhio: Agorà API versione 0.3.1, descritta con OpenAPI 3.0, con le operazioni raggruppate in Fields, Soils, Crops ed Extras.
-
Le operazioni sui campi: crea un campo, registra un’irrigazione, consulta il profilo e le irrigazioni effettuate, poi leggi lo storico e le previsioni degli output e del meteo.
-
Gestisci la stagione e la modalità operativa di un campo, oppure eliminalo. Il gruppo Soils permette di creare, elencare, leggere ed eliminare suoli, oltre a cercarli e consultarne le fonti disponibili.
-
Il catalogo delle colture: creazione, elenco, lettura ed eliminazione. L’ID restituito da
GET /cropsserve a indicare la coltura quando registri un campo.
Account demo condiviso — chi la apre vede e può modificare gli stessi dati. Registrati per farti attivare un account tuo.