Point d'entrée et Schema GraphQL

Vous avez maintenant les pré-requis pour avancer sur votre propre client des API de Démarche Simplifiées :

• vous disposez d'un compte administrateur sur demarches-simplifiees.fr

• vous avez une démarche de test publiée (vous pouvez en créer une)

• vous arrivez à structurer des appels à l'API en combinant la query qui détermine les données que vous souhaitez récupérer, et les variables qui déterminent la logique métier que nous devons appliquer. Bref, vous avez pris vos aises sur le playground, avec votre démarche de test et votre compte administrateur.

Vous pouvez maintenant ouvrir votre éditeur de code préféré et garder en tête que :

Les requêtes sont à envoyer au endpoint : https://www.demarches-simplifiees.fr/api/v2/graphql

Les requêtes doivent être envoyées avec le verbe HTTP POST

Les headers doivent contenir le jeton d'authentification au format attendu confère : jeton d'authentification

Le corps de votre requete POST, doit être un JSON respectant la spécification GraphQL

Cette adresse n’est pas visitable dans un navigateur. Elle renvoie des données au format JSON, à travers un transport HTTPS.

Pour plus d'information concernant le schema, vous pouvez:

• consulter la documentation : https://www.demarches-simplifiees.fr/graphql/schema/index.html

• consulter le fichier graphql.schema : https://github.com/demarches-simplifiees/demarches-simplifiees.fr/blob/main/app/graphql/schema.graphql (attention il peut être en avance par rapport à l'environnement de production)

• utiliser GraphiQL explorer du playground : https://www.demarches-simplifiees.fr/graphql/