# API GraphQL

L'API (**A**pplication **P**rogramming Interface) permet d'interconnecter **demarche.numerique.gouv.fr** à d'autres systèmes d'information ou d'autres logiciels. 

Aujourd'hui notre API est **sortante et entrante.** Vous pouvez donc aussi bien **lire que écrire des données dans demarche.numerique.gouv.fr**.

### Quelques exemples de données que vous pouvez récupérer depuis **demarche.numerique.gouv.fr**  :

* les informations d'une démarche,
* la liste des dossiers d'une démarche,
* le détail d'un dossier
* etc...

### Quelques exemples de données que vous pouvez écrire dans **demarche.numerique.gouv.fr** :

* Envoyer un message à l'usager d'un dossier ;
* Changer l'état d'un dossier (accepté, refusé, etc…)
* etc...

### Exemples de cas d'usage de l'API : 

* construire des tableaux bord afin de piloter le déploiement d'une démarche
* utiliser **demarche.numerique.gouv.fr** pour ses formulaires et verser les dossiers saisis par les usagers dans votre Système d'Information afin de les instruire vous-même.
* construire une interface sur mesure pour instruire les dossiers dans votre application

### Comment accéder à l'API ?

Si vous n'avez pas un profil technique, **nous vous invitons à contacter une personne de votre service informatique qui sera à même de réaliser l'intégration de l'API en fonction de vos besoins.**