Passer au contenu principal

API

Netuno dispose d'un framework propre pour créer des API REST de manière low-code, avec le support de JWT (JSON Web Token) et d'OpenAPI 3.0.

Tout le framework pour le développement de services web dans Netuno est très polyvalent, permettant de réaliser tout type de développement.

Le framework apporte déjà de nombreuses fonctionnalités pour le développement low-code, économisant de nombreuses lignes de code pour répondre aux besoins les plus courants tels que l'envoi d'e-mails, la consommation d'autres API REST, l'intégration avec d'autres bases de données, la génération de fichiers PDF et Excel, l'envoi de SMS, la manipulation de données de base de données, entre autres.

Et lorsqu'il n'existe pas de solutions dans le framework de Netuno, il est possible d'intégrer facilement des bibliothèques Java, Kotlin ou même JavaScript existantes pour développer des ressources sur mesure et les intégrer avec le framework de Netuno.

JWT - JSON Web Token​

Le JWT.io est la spécification du standard pour le passage de données du contexte de session au client, via un objet JSON.

Ainsi, le serveur n'a pas besoin de conserver les données sensibles des utilisateurs connectés en session, mais il s'agit d'un token qui est transmis au client, et par la suite, à chaque requête, ce token doit être retourné.

Ce token subit certains contrôles de sécurité, comme le délai d'expiration et un processus permettant de créer un nouveau token sans exiger une nouvelle authentification.

Netuno intègre le support de JWT, il est simple et facile à utiliser, il fonctionne également intégré avec les utilisateurs et l'authentification native de Netuno.

OpenAPI 3.0​

Après le succès de Swagger v1 et v2 qui sont depuis longtemps devenus un standard pour le développement de la définition des web services et la génération du code client.

Ainsi, Swagger a rendu sa définition ouverte et est devenu OpenAPI 3.

Où il continue d'être la base pour définir le standard de la documentation de l'API et de la génération des clients pour consommer l'API.

Netuno apporte déjà toute l'intégration avec OpenAPI 3.0 et utilise la définition d'OpenAPI avec la validation du JSON Schema.

Cela signifie que Netuno permet également de valider l'input et l'output des web services, en recourant à la validation du schéma du JSON obtenu et retourné ainsi pour :

  • Input : Si un appel au web service ne respecte pas la structure et les validations, alors il est rejeté
  • Output : Si les données retournées ne respectent pas la structure et les validations définies, alors une alerte est générée indiquant que le web service n'est pas conforme.

Ainsi, non seulement Netuno évite la création de nombreux ifs dans le code pour la validation des données reçues, mais garantit également une validation du résultat que le web service génère, en réalisant un test unitaire.

De plus, la structure de l'OpenAPI générée par Netuno peut être utilisée avec l'Éditeur Swagger pour générer l'interface de tests, la documentation et le code pour les clients de l'API dans d'autres technologies.

Basique​

Netuno prend également en charge la création de web services et l'authentification sans complications, c'est-à-dire qu'il n'est pas obligatoire d'utiliser JWT ou OpenAPI, bien que ce soit la recommandation par défaut.

Souvent, pour accélérer la création de l'API ou dans des situations impliquant la communication entre serveurs, on choisit de simplifier au maximum et de gagner du temps.

Netuno permet de réaliser l'authentification HTTP.