api.gouv.fr catalogue les API 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.

Public visé

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 !

Sous-domaines

Le nom de domaine api.gouv.fr héberge un catalogue d'API et de services les réutilisant.

Les sous-domaines en *.api.gouv.fr hébergent les API cataloguées sur api.gouv.fr et maintenues par la DINSIC.

Installation locale

Il est nécessaire de récupérer les sources avec la commande :

git clone https://github.com/betagouv/api.gouv.fr.git
cd api.gouv.fr

Il existe ensuite deux manières de lancer le site sur sa machine :

• Utiliser Jekyll directement.
• Utiliser Docker.

Ces deux méthodes sont indépendantes et détaillées ci-dessous.

Jekyll

Le site utilise Jekyll, un générateur de site statique en Ruby.

Dépendances

• Ruby. Il est recommandé d'utiliser un système de virtualisation comme RVM ou RbEnv. La version à utiliser est : 2.5.1
• bundler. La commande a lancer est : gem install bundler

Commandes

• bundle install pour installer toutes les dépendances nécessaires
• bundle exec jekyll serve pour lancer un serveur de développement. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.
• bundle exec jekyll build pour générer le site dans le répertoire _site.
• bundle update pour mettre à jour les dépendances et le Gemfile.lock

Docker

Dépendances

• Docker (version > 1.10)
• docker-compose (version > 1.6)

Commandes

• docker-compose up. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.

Déploiement

Production

Pour déployer ce site, il suffit de pousser les modifications vers la branche master sur github.com/betagouv/api.gouv.fr. Cette branche étant protégée, il convient de faire des pull requests car le projet utilise GitHub flow.

Développement

Chaque pull request est déployé dans des review app sur Heroku. Le compte utilisé est le compte de Thibaut Géry