API GraphQL de Camino

L'API GraphQL de Camino permet d'accéder aux données et de les modifier.

Format

Les données sont retournées au format JSON.

URL

L'API GraphQl de Camino est accessible à cette url : api.camino.beta.gouv.fr/.

La documentation de cette API est consultable dans l'onglets Docs (en haut à droite) de l'application GraphiQL.

GraphiQL est une application qui permet de consulter la documentation et de tester une API GraphQL dans un navigateur. Concernant l'API Camino, cette application est accessible à l'url racine de l'API: api.camino.beta.gouv.fr/.

Des exemples de requêtes se trouvent dans ce dossier.

Requêtes simples

Par exemple, pour obtenir la liste des substances:

copier une requête dans le champs principal de l'interface de GraphiQL: substances.graphql
valider en cliquant sur le bouton ▶.

Requêtes avec des variables

Certaines requêtes nécessitent le passage de variables. Par exemple, pour obtenir la liste des titres:

copier la requête dans le champs principal de l'interface de GraphiQL: titres.graphql
copier les variables dans le champs query variables (en bas à gauche de l'écran): titres-variables.json
valider en cliquant sur le bouton ▶.

Requêtes nécessitant une authentification

Certaines requêtes sont protégées et nécessitent une authentification par token (jwt). Pour les tester, il faut passer le token dans le header http de la requête. Cela n'est pas possible avec GraphiQL. C'est possible avec GraphQL Playground, GraphiQL App.

Liens

Documentation offcielle de GraphQL