curl

L'interface GraphQL est appelée via des requêtes POST avec un corps JSON. Aucune authentification n'est requise.

Requête unique

curl -X POST https://data.bafu.admin.ch/api \
  -H "Content-Type: application/json" \
  --data '{"query":"{ water { observations { stations(where:{status:{_eq:\"Aufgebaut\"}}, limit: 5) { no name riverName } } } }"}'

La réponse suit la spécification GraphQL : un appel réussi contient un objet data, un appel en échec un objet errors.

Requête depuis un fichier

Les requêtes plus longues sont enregistrées dans un fichier et soumises avec --data-binary. Sauts de ligne et guillemets sont préservés.

cat > query.graphql <<'EOF'
{
  water {
    observations {
      data_1day_mean(
        where: {
          station: { no: { _eq: "2009" } }
          timestamp: { _gte: "2026-01-01T00:00:00Z", _lt: "2026-02-01T00:00:00Z" }
        }
      ) {
        timestamp
        parameterName
        value
        unitSymbol
      }
    }
  }
}
EOF

curl -X POST https://data.bafu.admin.ch/api \
  -H "Content-Type: application/json" \
  --data-binary "$(jq -Rs '{query: .}' < query.graphql)"

Requête avec variables

curl -X POST https://data.bafu.admin.ch/api \
  -H "Content-Type: application/json" \
  --data @- <<'EOF'
{
  "query": "query DailyMean($from: AWSDateTime!, $to: AWSDateTime!, $station: String!) { water { observations { data_1day_mean(where: { station: { no: { _eq: $station } } timestamp: { _gte: $from, _lt: $to } }) { timestamp parameterName value unitSymbol } } } }",
  "variables": {
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-02-01T00:00:00Z",
    "station": "2009"
  }
}
EOF

Remarques

• L'en-tête Content-Type: application/json est requis.
• Les guillemets doubles dans la requête doivent être échappés (\") lorsqu'ils sont passés via --data '…'. L'échappement n'est pas nécessaire lorsque la requête est lue depuis un fichier.
• Le statut HTTP est 200 même pour les requêtes en échec. Le champ errors de la réponse indique les problèmes.