2–Le terme "API traditionnelles" n'a pas de définition précise et formelle dans le contexte des APIs. Cependant, il est souvent utilisé pour faire référence aux APIs qui ne suivent pas les principes de l'architecture REST (Representational State Transfer) et qui utilisent des protocoles et des styles d'architecture spécifiques.

Dans les API, le HTTP est le principal protocol de communication et de transmission d’informations.

HTTP/2 est la dernière version utilisée par les API REST.

Dans les API, HTTP est utilisé pour envoyer des requêtes au serveur d'API et recevoir des réponses. Les méthodes HTTP GET, POST, PUT et DELETE sont utilisées pour représenter les opérations CRUD (Create, Read, Update, Delete). Les données envoyées et reçues sont généralement codées en JSON ou XML.

Le rôle du HTTP dans les APIs est qu’il leur permettent de communiquer et de transférer des informations, remplissant les fonctions suivantes - création, lecture, mise à jour et suppression de données.

Le rôle d'HTTP dans les API est crucial, car il est le protocole de communication de base utilisé par les clients et les serveurs pour interagir avec une API. 

Dans le contexte de l'architecture RESTful, le client est l'application qui fait la demande au serveur, et le serveur est l'application qui répond à la demande. Le client et le serveur communiquent à l'aide du protocole HTTP.

Ce premier principe indique essentiellement que les serveurs et les clients ne doivent connaître que les URL des ressources et c'est tout. Il n'y a pas de dépendance. Chacun peut être développé et remplacé indépendamment tant que l'interface entre eux reste inchangée.

Ce premier principe indique essentiellement que les serveurs et les clients ne doivent connaître que les URL des ressources et c'est tout. Il n'y a pas de dépendance. Chacun peut être développé et remplacé indépendamment tant que l'interface entre eux reste inchangée.

- Interopérabilité: Ils sont hautement interopérables et peuvent facilement interagir , se synchroniser et s'intégrer avec d'autres applications.

-Flexibilité: Ils peuvent gérer des milliers, des millions et des milliards de données simultanément sans affecter les performances.

-Sécurité: Les API REST utilisent généralement l'authentification via des jetons d'accès.

-Facilité d'utilisation: Les API REST sont plus simples et plus faciles à utiliser que les autres API.

- Complexité de conception accrue: Bien qu'elles soient plus faciles à utiliser, la conception d'une API REST peut être plus complexe que d'autres API, surtout si vous n'êtes pas familier avec l'architecture Web. 

-Connexion internet: Une API REST nécessite une connexion Internet pour fonctionner, ce qui signifie qu'elle peut être moins utile dans les environnements hors ligne.

- Performances variables et flexibilité: Une API REST peut être moins flexible que d'autres API en raison des principes architecturaux qu'elle doit suivre. 

Les bonnes pratiques pour gérer la compatibilité des version

-Mettre en place un contrôle d'accès: Les organisations qui souhaitent permettre à des tiers d'accéder aux données et systèmes internes via des API doivent introduire et tester des contrôles pour gérer cet accès.

- Crypter les requêtes et les réponses: Tout le trafic réseau doit être chiffré, en particulier les requêtes et les réponses API, car elles contiendront probablement des informations d'identification et des données sensibles.

Évaluez les risques de votre API: Une autre bonne pratique importante en matière de sécurité des API consiste à effectuer une évaluation des risques pour toutes les API de votre registre existant.

-Ne partagez que les informations nécessaires: Les réponses de l'API incluent souvent un enregistrement de données complet plutôt que seulement les champs pertinents, s'appuyant sur l'application cliente pour filtrer ce qu'un utilisateur voit.

-Stockez vos clés API: Les clés d'API identifient et vérifient l'accès pour l'application ou le site qui appelle une API. Ils peuvent également bloquer ou limiter les appels effectués vers une API et identifier les modèles d'utilisation.

Authentification : Utilisez une méthode d'authentification solide pour vérifier l'identité des clients qui accèdent à l'API.

Autorisation : Mettez en place un mécanisme d'autorisation robuste pour définir les droits d'accès des utilisateurs et contrôler les actions qu'ils peuvent effectuer sur les ressources de l'API.

HTTPS (HTTP sécurisé) : Assurez-vous de toujours utiliser HTTPS pour chiffrer les communications entre les clients et l'API.

Protection contre les attaques par injection : Évitez les vulnérabilités d'injection en utilisant des techniques de validation et de filtrage des données d'entrée.

Limite de taux (Rate limiting) : Mettez en place des limites de taux pour contrôler le nombre de requêtes qu'un client peut effectuer sur l'API dans un laps de temps donné.

Protection contre les attaques de contournement d'authentification : Assurez-vous de mettre en œuvre des mécanismes de sécurité pour prévenir les attaques de contournement d'authentification, telles que la fixation de session (session fixation), l'injection de tokens

Validation et filtrage des entrées : Assurez-vous de valider et de filtrer les données d'entrée reçues des clients pour prévenir les attaques telles que les injections SQL, les scripts intersites (XSS) et les attaques de contournement des contrôles de sécurité.

Journalisation et surveillance : Mettez en place des mécanismes de journalisation et de surveillance pour suivre et détecter les activités suspectes ou les tentatives d'attaques. 

Mises à jour et correctifs réguliers : Assurez-vous de maintenir votre API à jour en appliquant régulièrement les correctifs de sécurité et en mettant à jour les dépendances logicielles.

Tests de sécurité : Effectuez régulièrement des tests de sécurité, tels que des tests de pénétration (penetration testing) et des tests d'intrusion (security auditing), pour identifier les éventuelles failles de sécurité et les vulnérabilités dans votre API.

Utiliser l'authentification et l'autorisation : l'authentification est le processus de vérification de l'identité d'un utilisateur ou d'un client. L'autorisation est le processus de détermination des ressources auxquelles un utilisateur ou un client est autorisé à accéder. 

Utiliser des clés API : les clés API sont un bon moyen d'authentifier et d'autoriser l'accès aux API RESTful. Les clés API sont des chaînes uniques attribuées à chaque client. Les clients doivent fournir leurs clés API lorsqu'ils font des demandes à l'API. Cela permet de garantir que seuls les clients autorisés peuvent accéder à l'API.

Filtrer les données d'entrée : les API RESTful reçoivent souvent des données d'entrée des clients. Ces données peuvent être malveillantes, il est donc important de les filtrer avant qu'elles ne soient traitées par l'API. Cela peut aider à empêcher les attaquants d'injecter du code malveillant dans l'API.

Utiliser la limitation de débit : la limitation de débit est une technique qui limite le nombre de requêtes qu'un client peut adresser à une API au cours d'une période donnée. Cela permet d'éviter que l'API ne soit surchargée par des requêtes malveillantes.

Consigner toutes les requêtes : il est important de consigner toutes les requêtes adressées à une API RESTful. Cela permet de suivre toute activité suspecte et d'identifier toute faille de sécurité.

En effet, c’est un outil qui aide les développeurs dans les points suivants: créer, tester, partager et documenter des API.

Création de collections d'API : Dans Postman, les développeurs peuvent regrouper des requêtes liées dans des collections d'API.

Configuration des requêtes : Les développeurs peuvent configurer les requêtes en spécifiant l'URL de l'API, la méthode HTTP (GET, POST, PUT, etc.).

Test des requêtes : Postman permet aux développeurs d'envoyer les requêtes configurées à l'API et de recevoir les réponses correspondantes.

Enregistrement des requêtes dans les collections : Les développeurs peuvent enregistrer les requêtes exécutées dans des collections, ce qui leur permet de les réutiliser ultérieurement.

Automatisation des tests : Postman permet d'automatiser les tests en créant des scripts de test.

Génération de documentation : Postman facilite la création de documentation d'API en extrayant automatiquement les détails des requêtes et des collections.

Collaboration : Postman propose des fonctionnalités de collaboration qui permettent aux membres de l'équipe de partager et de travailler ensemble sur des collections d'API. 

Environnements de développement : Postman permet de gérer des environnements de développement spécifiques, avec des variables d'environnement pour stocker des valeurs telles que les URL, les clés d'API ou les jetons d'authentification

Pour définir une variable en Postman, vous pouvez suivre ces étapes :

Dans l'interface de Postman, accédez à l'onglet "Manage Environments" (Gérer les environnements) situé dans la barre latérale.

Cliquez sur le bouton "Add" (Ajouter) pour créer un nouvel environnement ou sélectionnez un environnement existant dans lequel vous souhaitez définir la variable.

Vous pouvez également définir la portée de la variable en la rendant globale à tous les appels dans la collection ou spécifique à une requête particulière.

Une fois que vous avez ajouté la variable, vous pouvez la référencer dans les parties pertinentes de vos requêtes en utilisant la syntaxe des variables de Postman.

Swagger (OpenAPI) :

Swagger est une spécification de description d'API qui permet de décrire les fonctionnalités, les opérations, les paramètres, les réponses et d'autres aspects d'une API. Il s'agit d'un format standardisé et ouvert pour la documentation des API RESTful.

Postman est une plateforme qui permet de tester, de déboguer et de documenter les API. Il offre une interface utilisateur conviviale pour envoyer des requêtes HTTP aux API, afficher les réponses, gérer les variables d'environnement, automatiser les tests et générer de la documentation.

Accéder à l'interface Swagger UI : Une fois que votre projet est en cours d'exécution, vous pouvez accéder à l'interface Swagger UI en utilisant l'URL suivante : http://localhost:8080/swagger-ui.html. Assurez-vous de modifier l'URL en fonction du port et du contexte de votre application.

Documenter vos API : Utilisez les annotations Swagger appropriées dans vos classes de contrôleurs pour documenter vos API. Par exemple, vous pouvez utiliser @ApiOperation pour documenter une méthode de contrôleur et @ApiParam pour documenter les paramètres de méthode.

}
Lorsque vous avez intégré Swagger à votre projet Java et que l'interface Swagger UI est disponible, vous pouvez accéder et tester vos API de la manière suivante :

Accéder à l'interface Swagger UI : Ouvrez un navigateur Web et accédez à l'URL de l'interface Swagger UI. Par défaut, l'URL est généralement http://localhost:8080/swagger-ui.html. Assurez-vous de modifier l'URL en fonction du port et du contexte de votre application.

Explorer les endpoints : Une fois dans l'interface Swagger UI, vous verrez une liste des endpoints de votre API classés par catégories. 

Tester les endpoints : Pour tester un endpoint, cliquez sur l'endpoint souhaité dans l'interface Swagger UI.

Remplir les paramètres : Si l'endpoint nécessite des paramètres, vous pouvez les remplir directement dans l'interface Swagger UI.

Envoyer la requête : Une fois que vous avez rempli les paramètres, vous pouvez cliquer sur le bouton "Try it out" pour envoyer la requête vers l'endpoint. 

Vérifier la réponse : Après avoir envoyé la requête, vous pouvez vérifier la réponse renvoyée par votre API

Explorer d'autres fonctionnalités : En plus de tester les endpoints, Swagger UI offre également d'autres fonctionnalités utiles, telles que la possibilité de basculer entre différents environnements de serveur, de partager des liens vers des endpoints spécifiques et de consulter la documentation générée automatiquement pour chaque endpoint.