API

Tutti i dati di questo sito sono disponibili anche in formato leggibile da macchina: lookup CAP, risultati di analisi con provenienza completa e valori di parametro versionati — come JSON, read-only. L'API serve in primo luogo ai nostri sistemi; l'uso esterno è possibile su richiesta (Free Tier, 1.000 richieste/giorno).

Richiedi accesso

Descrivi brevemente per cosa vuoi usare i dati — esaminiamo la richiesta e inviamo la key per e-mail, di norma entro pochi giorni lavorativi.

Quickstart

curl "https://maunawai.info/v1/lookup?plz=50823" \
  -H "X-Api-Key: mwi_..."

Risposta: zone di approvvigionamento del CAP con gestore idrico, quota di superficie e confidenza. Valori per zona: GET /v1/zones/{id}.

Endpoints

Endpoint API disponibili
Endpoint	Descrizione	Accesso
GET /v1/lookup?plz=	CAP → zone, gestori idrici, ambiguità	Key
GET /v1/zones/{id}	Zona: valori attuali + collocazione rispetto al valore di parametro + fonti	Key
GET /v1/zones/{id}/measurements	Tutti i punti dati di una zona (serie storica, verbatim)	Key
GET /v1/suppliers/{id}	Gestore idrico + le sue zone	Key
GET /v1/parameters	Registro dei parametri (282 parametri)	aperto
GET /v1/parameters/{code}/limits	Valori di parametro versionati (p. es. PFAS-20 dal 12.01.2026)	Key
GET /v1/export/plz-zonen	Mapping completo CAP↔zone, JSON/CSV — ODbL	aperto
POST /v1/keys/antrag	Richiedere l'accesso (esame, key per e-mail)	aperto

Riferimento completo con schemi: documentazione interattiva (OpenAPI) · openapi.json

Licenza

Aperto (ODbL): il mapping CAP↔zone (/v1/export/plz-zonen) si basa su dati OpenStreetMap ed è disponibile sotto la Open Database License v1.0 — attribuzione: «© maunawai.info / © OpenStreetMap contributors».

Proprietario: la banca dati dei valori misurati (risultati di analisi, storico, provenienza). Uso nell'ambito del Free Tier; i termini formali dell'API seguiranno. Tutti i valori provengono dalle pubblicazioni obbligatorie dei gestori idrici collegate e non sono ufficiali.

Beta: gli endpoint possono ancora cambiare. Feedback benvenuto.