Formato della risposta

Le risposte seguono la specifica GraphQL. Ogni risposta contiene il campo data (risultato della richiesta) e/o il campo errors (elenco degli errori riscontrati).

Richiesta riuscita

{
  "data": {
    "water": {
      "observations": {
        "data_1day_mean": [
          {
            "timestamp": "2026-01-01T00:00:00Z",
            "parameterName": "Q",
            "value": 65.4,
            "unitSymbol": "m³/s",
            "station": { "no": "2009", "name": "Aare – Brienzwiler" }
          }
        ]
      }
    }
  }
}

I campi non richiesti non sono inclusi. Gli oggetti annidati vengono restituiti nella stessa richiesta; non è necessaria una chiamata aggiuntiva per risolvere la struttura annidata.

Richiesta fallita

In caso di richiesta fallita, lo stato HTTP rimane 200. Il campo data può essere null; gli errori figurano sotto errors.

{
  "data": null,
  "errors": [
    {
      "message": "limit cannot exceed 10000 rows per query",
      "path": ["water", "observations", "data_1day_mean"]
    }
  ]
}

Messaggi d'errore comuni

Messaggio	Causa
limit cannot exceed 10000 rows per query	limit oltre il massimo. Vedi Pagination.
Query returned more than 10000 rows. Please narrow your query using filters or specify a limit.	Insieme di risultati troppo grande; nessun troncamento. Vedi Pagination.
Query requires at least one of these filters: …. This prevents expensive full table scans.	Filtro obbligatorio mancante. Vedi Filtri e operatori.
Filter nesting depth exceeds maximum of 5 levels	_and/_or/_not annidati troppo in profondità.
Unknown operator: …	Operatore di confronto non supportato. Vedi Filtri e operatori.

Anche gli errori di validazione dello schema GraphQL (ad esempio nomi di campo sconosciuti o argomenti obbligatori mancanti) figurano sotto errors, tipicamente con stato 400.

Tipi di dato

Tipo GraphQL	Rappresentazione JSON
String	stringa
Int	intero
Float	numero in virgola mobile
AWSDateTime	stringa ISO-8601 in UTC, ad es. "2026-01-01T00:00:00Z"
null	null

Ordine dei risultati

L'ordine dei record nell'array non è definito e può variare tra chiamate consecutive. L'ordinamento per tempo o per altra colonna avviene lato client.