02_API

Tout d’abord, l'utilisateur crée une Base Adresse Locale (BAL). La commune est désormais obligatoire à la création.

La BAL est un fichier contenant toutes les adresses d'une unique commune, structuré au format Base Adresse Locale (BAL) (1.4). Ce fichier peut aussi être importé.

Ensuite, il peut gérer les voies (et toponymes), les numéros et les positions associées.

Règles de relations

• Une base locale ne peut avoir qu'une seule commune
• Une commune a plusieurs voies
• Une voie est associée à une seule commune.
• Une voie a plusieurs numéros (sauf les voies-toponymes)
• Un numéro est associé à une seule voie.
• Un numéro peut avoir plusieurs positions.
• Une position est associée à un seul numéro ou à une seule voie (dans le cas d'une voie-toponyme).
• Une parcelle est associée à une ou plusieurs adresses.
• Une base locale peut être publiée, ou exportée au format BAL/AITF 1.4.

Contrôle d'accès

Le créateur d'une base locale devient l'administrateur de cette base. Un jeton de sécurité lui est alors fourni.

Ce jeton est lié à la base locale, et peut-être renouvelé sur demande de tout utilisateur disposant du jeton.

Si le jeton est perdu, un nouveau peut être envoyé par email sous réserve de communiquer au moins une adresse email connue.

Le jeton doit être passé à l'API via l'en-tête HTTP Authorization.

Exemple : Authorization: Bearer f66gdjfehfv66DBD

Points d'accès

https://api-bal.adresse.data.gouv.fr/api

Les routes protégées sont marquées d'un petit cadena sur le swagger