POC GraphQL

Comme discuté j’ai fait un POC pour que l’API fonctionne en graphQL, ce qui a l’avantage de documenter ce qu’on fait, d’avoir des libs standards, et aussi d’être plus fins sur ce qu’on veut retourner

après un make rundev, on a accès à http://localhost:8000/graphql qui est une interface pour interroger notre endpoint qui ressemble à ça

On voit qu’on peut faire des requêtes qui peuvent être écrites comme ça

{
  departement(code:"90") {
    code
    libelle
    indicateurs {
      nombre_villes_acv: indicateur {
        valeur
      }
    }
  }
}

dans indicateurs a une fonction indicateur qui retourne des indicateurs. Par défaut le nom de l’indicateur est le nom de l’alias qui appelle la fonction, mais on peut aussi passer un identifiant et un namespace.

On peut aussi demander les metadata comme on le voit dans le screenshot