loading...

Traduire REST en GraphQL avec LoopBack 4 et OpenAPI-to-GraphQL ...

deep75 profile image Karim ・3 min read

LoopBack est un framework Node.js open source hautement extensible qui vous permet de:

  • Créer des API REST de bout en bout dynamiques avec peu ou pas de codage.
  • Accéder aux données des principales bases de données relationnelles, MongoDB, SOAP et API REST.
  • Intégrer des relations de modèle et des contrôles d'accès pour des API complexes.
  • Utiliser des composants séparables pour le stockage de fichiers, la connexion tierce et OAuth 2.0.

LoopBack est un framework Node.js et TypeScript open source hautement extensible basé sur Express qui vous permet de créer rapidement des API et des microservices composés de systèmes backend tels que des bases de données et des services SOAP ou REST.

https://loopback.io/

Je crée pour ce test une petite instance Ubuntu 18.04 LTS dans Hetzner Cloud :

J'y installe Node.js :

Puis j'installe le client LoopBack via NPM :

La CLI LoopBack 4 est une interface de ligne de commande qui peut échafauder un projet ou une extension. La CLI fournit le moyen le plus rapide pour démarrer avec un projet LoopBack 4. Je peux alors créer un nouveau projet :

Dans ce projet test, je peux démarrer rapidement avec une route "Ping" fournie :

Je peux ajouter un simple contrôleur "Hello World" comme suit :

via ce fichier TypeScript :

et je redémarre le tout avec npm start :

Test rapide avec HTTPie :

J'aurais pû également réutiliser un des exemples fournis dans le dépôt Github de LoopBack :

Le projet Todo répond avec OpenAPI et son fichier de spécification :

et sa documentation via Swagger :

J'effectue la traduction de cet API REST en GraphQL via OpenAPI-to-GraphQL. OpenAPI-to-GraphQL peut être utilisé soit comme une bibliothèque, soit via son interface de ligne de commande (CLI) pour démarrer rapidement. J'installe la CLI OpenAPI-to-GraphQL :

Je récupère le fichier openapi.json de l'API REST et j'utilise la CLI pour lancer ma traduction avec l'API GraphQL :

et accessible :

d'où cette requête simple avec GraphQL :

Je peux aussi réutiliser un exemple d'API REST existant comme le Swagger Petstore avec OpenAPI :

qui me permet de lancer une simple requête avec GraphQL :

Je peux aussi substituer LoopBack par FastAPI :

https://fastapi.tiangolo.com/

Installation rapide de FastAPI via pip :

et lancement de l'API REST avec OpenAPI via ce simple script python :

Je peux récupérer le fichier openapi.json :

Je lance ma traduction en GraphQL :

avec cette simple requête :

À suivre ! ...

Discussion

pic
Editor guide