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
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.