Autocomplete-Demo

1 Authentifizierung

Die API verwendet den OAuth 2.0 Client-Credentials-Flow. Die Authentifizierung erfolgt serverseitig — Ihre Zugangsdaten werden nie an den Browser übertragen.

POST /oauth2/token
grant_type=client_credentials
client_id=••••••••
client_secret=••••••••
Token erfolgreich abgerufen
eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…
Zugangsdaten verbleiben serverseitig. Der Browser erhält nur ein kurzlebiges Zugriffstoken.
2 Adresse suchen

Tippen Sie eine beliebige Schweizer Adresse ein — Strasse, Ort, Postleitzahl oder eine Kombination. Vorschläge erscheinen während der Eingabe, sortiert nach Relevanz.

Verwendeter API-Endpunkt

GET /api/addresses/autocomplete?query=<text>&limit=10&threshold=0.3

Autorisierung: Bearer <token>

X-HelvAddress-API-Version: 1.0.0

Vollständige API-Referenz
3 Adressdetails
🏠

Wählen Sie eine Adresse aus den Vorschlägen, um ihre Details anzuzeigen.

Adressnormalisierung Demo

1 Authentifizierung

Gleicher OAuth 2.0-Token wie oben — keine zusätzliche Authentifizierung erforderlich.

POST /oauth2/token
grant_type=client_credentials
Token erfolgreich abgerufen
eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…
Zugangsdaten verbleiben serverseitig. Der Browser erhält nur ein kurzlebiges Zugriffstoken.
2 Freitextadresse eingeben

Geben Sie eine Schweizer Adresse ein — abgekürzt, falsch geschrieben oder unstrukturiert. Die API analysiert und validiert sie anhand des offiziellen Schweizer Bundesregisters.

Verwendeter API-Endpunkt

POST /api/addresses/normalize (Content-Type: text/plain)

Body (text/plain): Freitextadresse

Vollständige API-Referenz
3 Normalisiertes Ergebnis
🔍

Adresse eingeben und auf Normalisieren klicken, um das strukturierte Ergebnis zu sehen.