Mes adresses api est un dispositif logiciel composé de deux application
- API: permettant la gestion de bases d’adresses à l’échelon local coupler avec Mes adresses
- CRON: permettant le deploiement continue des BALs de mes-adresses-api vers Api de depot
https://adresse-data-gouv-fr.gitbook.io/bal/mes-adresses
Le base de donnée postgres doit avoir l'extension postgis d'installé
CREATE EXTENSION postgis
Installation des dépendances Node.js
yarn
Créer les variables d'environnement
cp .env.sample .envOn pourra ensuite éditer les variables d'environnement dans le fichier .env si nécessaire.
Lancer l'api de développement :
$ yarn dev:api
Lancer le cron de développement :
$ yarn dev:cron
Créer une version de production :
$ yarn build
Démarrer l'api (port 3000 par défaut) :
$ yarn start:api
Démarrer le cron :
$ yarn start:cron
Mettre a jour les liste des communes (code insee) qui ont un cadastre
yarn update-cadastre
Rapport des tests (jest) :
$ yarn test
Rapport du linter (eslint) :
$ yarn lint
Cette application utilise des variables d'environnement pour sa configuration.
Elles peuvent être définies classiquement ou en créant un fichier .env sur la base du modèle .env.sample.
| Nom de la variable | Description |
|---|---|
POSTGRES_URL |
Url de connection a la db postgres |
PORT |
Port à utiliser pour l'API |
API_URL |
URL de base de l’API |
API_DEPOT_URL |
URL de l'api-depot |
API_DEPOT_CLIENT_ID |
Id du client de l'api-depot |
API_DEPOT_CLIENT_SECRET |
Token du client de l'api-depot |
EDITOR_URL_PATTERN |
Pattern permettant de construire l'URL vers l'édition d'une BAL |
BAN_API_URL |
URL de ban-plateform |
| --- | --- |
SMTP_HOST |
Nom d'hôte du serveur SMTP |
SMTP_PORT |
Port du serveur SMTP |
SMTP_USER |
Nom d'utilisateur pour se connecter au serveur SMTP |
SMTP_PASS |
Mot de passe pour se connecter au serveur SMTP |
SMTP_SECURE |
Indique si le serveur SMTP nécessite une connexion sécurisée (YES) |
SMTP_FROM |
Adresse à utiliser en tant qu'expéditeur des emails |
SMTP_BCC |
Adresse(s) en copie cachée à utiliser pour tous les envois de notifications |
Toutes ces variables ont des valeurs par défaut que vous trouverez dans le fichier .env.sample.
Ce outil a été conçu à l'initiative d'Etalab. Il est depuis 2020 piloté conjointement par Etalab et l'ANCT.
MIT