Démo d'autocomplétion

1 Authentification

L'API utilise le flux OAuth 2.0 client credentials. L'authentification est gérée côté serveur — vos identifiants ne sont jamais envoyés au navigateur.

POST /oauth2/token

grant_type=client_credentials

client_id=••••••••

client_secret=••••••••

Jeton obtenu avec succès

eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…

Les identifiants restent côté serveur. Le navigateur reçoit uniquement un jeton d'accès à durée limitée.

2 Rechercher une adresse

Commencez à saisir n'importe quelle adresse suisse — rue, ville, code postal ou toute combinaison. Les suggestions apparaissent au fil de la saisie, classées par pertinence.

Endpoint API utilisé

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

Autorisation : Bearer <token>

X-HelvAddress-API-Version: 1.0.0

Référence API complète

3 Détails de l'adresse

🏠

Sélectionnez une adresse dans les suggestions pour afficher ses détails ici.

Démo de normalisation d'adresse

1 Authentification

Même jeton OAuth 2.0 qu'utilisé ci-dessus — aucune authentification supplémentaire requise.

POST /oauth2/token

grant_type=client_credentials

Jeton obtenu avec succès

eyJraWQiOiJhbHBhZGRyZXNzLWRldi1r…

Les identifiants restent côté serveur. Le navigateur reçoit uniquement un jeton d'accès à durée limitée.

2 Saisir une adresse en texte libre

Saisissez n'importe quelle adresse suisse — abrégée, mal orthographiée ou non structurée. L'API l'analyse et la valide sur la base du registre fédéral suisse officiel.

Endpoint API utilisé

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

Body (text/plain) : adresse en texte libre

Référence API complète

3 Résultat normalisé

🔍

Saisissez une adresse et cliquez sur Normaliser pour voir le résultat structuré.