Demo di autocompletamento

1 Autenticazione

L'API utilizza il flusso OAuth 2.0 client credentials. L'autenticazione è gestita lato server — le credenziali non vengono mai inviate al browser.

POST /oauth2/token
grant_type=client_credentials
client_id=••••••••
client_secret=••••••••
Token ottenuto con successo
eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…
Le credenziali rimangono lato server. Il browser riceve solo un token di accesso a breve durata.
2 Cerca un indirizzo

Inizia a digitare qualsiasi indirizzo svizzero — via, città, codice postale o qualsiasi combinazione. I suggerimenti appaiono mentre scrivi, ordinati per rilevanza.

Endpoint API utilizzato

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

Autorizzazione: Bearer <token>

X-HelvAddress-API-Version: 1.0.0

Riferimento API completo
3 Dettagli indirizzo
🏠

Seleziona un indirizzo dai suggerimenti per visualizzarne i dettagli qui.

Demo di normalizzazione indirizzo

1 Autenticazione

Stesso token OAuth 2.0 usato sopra — nessuna autenticazione aggiuntiva richiesta.

POST /oauth2/token
grant_type=client_credentials
Token ottenuto con successo
eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…
Le credenziali rimangono lato server. Il browser riceve solo un token di accesso a breve durata.
2 Inserisci un indirizzo in testo libero

Digita qualsiasi indirizzo svizzero — abbreviato, con errori di ortografia o non strutturato. L'API lo analizza e lo valida rispetto al registro federale svizzero ufficiale.

Endpoint API utilizzato

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

Body (text/plain): indirizzo in testo libero

Riferimento API completo
3 Risultato normalizzato
🔍

Inserisci un indirizzo e clicca su Normalizza per vedere il risultato strutturato qui.