api.gouv.fr catalogue les APIs offertes par les administrations centrales, les collectivités territoriales, les établissements publics… Chaque API est associée à une courte description fonctionnelle, une documentation technique, les modalités d'accès, d'éventuelles ressources supplémentaires et surtout des liens vers les services qui l'utilisent.
api.gouv.fr s'adresse avant tout aux créateurs de services, les consommateurs d'API. Pour cela, nous facilitons la découverte, la compréhension et l'accès aux API et à leurs producteurs.
Les fournisseurs, de leur côté, ont avec ce catalogue un moyen simple de faire connaître leurs API.
Fournisseur d'API ? Ajoutez votre API !
Réutilisateur d'API ? Ajoutez votre service !
- Node.js >= 12
Cette application utilise Next.js.
- Installer les dépendances
npm i
- Copier le fichier de configuration
cp .env.sample .env
- Lancer le serveur de développement
npm run dev
Par défaut, il écoutera sur le port 3000
, pour changer, utiliser npm run dev -p 4242
.
Afin de configurer le projet correctement, il est conseillé de créer un fichier .env
avec les variables d’environnement nécessaires à l’application.
.env
permet de persister les variables d’environnement de développement dans un fichier plutôt que de les définir dans le shell, mais les deux fonctionnent. Cela fonctionne avec dotenv et next-runtime-dotenv.
Cette application utilise Next.js.
- Installer les dépendances
npm i
- Générer les bundles de production
npm run build
- Lancer le serveur de production
PORT=3000 npm start
Chaque pull request est déployé dans des review app sur Heroku