Format de réponse

Les réponses suivent la spécification GraphQL. Chaque réponse contient le champ data (résultat de la requête) et/ou le champ errors (liste des erreurs rencontrées).

Requête réussie

{
  "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" }
          }
        ]
      }
    }
  }
}

Les champs non demandés ne sont pas inclus. Les objets imbriqués sont renvoyés dans la même requête ; aucun appel supplémentaire n'est nécessaire pour résoudre la structure imbriquée.

Requête en échec

Pour une requête en échec, le statut HTTP reste 200. Le champ data peut valoir null ; les erreurs figurent sous errors.

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

Messages d'erreur courants

Message	Cause
limit cannot exceed 10000 rows per query	limit au-dessus de la borne. Voir Pagination.
Query returned more than 10000 rows. Please narrow your query using filters or specify a limit.	Ensemble de résultats trop grand ; pas de troncature. Voir Pagination.
Query requires at least one of these filters: …. This prevents expensive full table scans.	Filtre obligatoire absent. Voir Filtres et opérateurs.
Filter nesting depth exceeds maximum of 5 levels	_and/_or/_not imbriqués trop profondément.
Unknown operator: …	Opérateur de comparaison non supporté. Voir Filtres et opérateurs.

Les erreurs de validation de schéma GraphQL (par exemple noms de champs inconnus ou arguments requis manquants) figurent également sous errors, typiquement avec un statut 400.

Types de données

Type GraphQL	Représentation JSON
String	chaîne
Int	entier
Float	nombre à virgule flottante
AWSDateTime	chaîne ISO-8601 en UTC, p. ex. "2026-01-01T00:00:00Z"
null	null

Ordre des résultats

L'ordre des enregistrements dans le tableau n'est pas défini et peut varier d'un appel à l'autre. L'ordonnancement par temps ou par toute autre colonne se fait côté client.