- Liste des tutoriels de test d'API
- Vue d'ensemble des tutoriels de cette série sur les tests d'API
- Tutoriel de test de l'API
- Introduire les tests d'API dans votre organisation
- Conclusion
Ce tutoriel approfondi sur les tests d'API explique tout sur les tests d'API, les services Web et la manière d'introduire les tests d'API dans votre organisation :
Ce tutoriel d'introduction vous permettra d'acquérir une connaissance approfondie des tests d'API, du concept de test shift-left et des services web.
Les concepts tels que l'API Web, le fonctionnement de l'API (avec un exemple concret) et la différence avec les services Web sont bien expliqués avec des exemples dans ce tutoriel.
Liste des tutoriels de test d'API
Tutoriel n° 1 : Tutoriel de test de l'API : un guide complet pour les débutants
Tutoriel n°2 : Tutoriel sur les services Web : composants, architecture, types et exemples
Tutoriel n°3 : 35 questions d'entretien avec réponses pour ASP.Net et Web API
Tutoriel n°4 : Tutoriel POSTMAN : Test d'API avec POSTMAN
Tutoriel n°5 : Test des services web à l'aide du client HTTP Apache
Vue d'ensemble des tutoriels de cette série sur les tests d'API
Tutoriel # | Ce que vous apprendrez |
---|---|
Tutoriel_#1 : | Tutoriel de test de l'API : un guide complet pour les débutants Ce tutoriel approfondi sur les tests d'API explique en détail les tests d'API et les services Web et vous apprend également à introduire les tests d'API dans votre organisation. |
Tutoriel_#2 : | Tutoriel sur les services Web : composants, architecture, types et exemples Ce tutoriel sur les services Web explique l'architecture, les types et les composants des services Web, ainsi que les terminologies importantes et les différences entre SOAP et REST. |
Tutoriel_#3 : | 35 questions d'entretien avec réponses pour ASP.Net et Web API Vous pouvez explorer la liste des questions d'entretien les plus fréquemment posées sur ASP.Net et Web API avec des réponses et des exemples pour les débutants et les professionnels expérimentés dans ce tutoriel. |
Tutoriel_#4 : | Tutoriel POSTMAN : Test d'API avec POSTMAN Ce tutoriel pas à pas explique le test d'API à l'aide de POSTMAN, ainsi que les bases de POSTMAN, ses composants et des exemples de requêtes et de réponses en termes simples pour faciliter la compréhension. |
Tutoriel_#5 : | Test des services web à l'aide du client HTTP Apache Ce tutoriel sur l'API traite de l'exécution de diverses opérations CRUD sur les services Web et du test des services Web à l'aide du client HTTP Apache. |
Tutoriel de test de l'API
Cette section vous aidera à acquérir une compréhension de base des services Web et des API Web, ce qui, à son tour, vous aidera à comprendre les principaux concepts des prochains tutoriels de cette série sur les tests d'API.
L'API (Application Programming Interface) est un ensemble de procédures et de fonctions qui nous permettent de créer une application en accédant aux données ou aux fonctionnalités du système d'exploitation ou des plateformes. Le test de ces procédures est connu sous le nom de test API.
Test du décalage à gauche
L'un des principaux types de tests demandés aujourd'hui dans les entretiens sur les tests d'API est le Shift Left Testing. Ce type de test est pratiqué dans presque tous les projets qui suivent une méthodologie Agile.
Avant l'introduction du Shift Left Testing, les tests de logiciels n'intervenaient qu'une fois le codage terminé et le code livré aux testeurs. Cette pratique entraînait une course de dernière minute pour respecter les délais et nuisait considérablement à la qualité du produit.
En outre, les efforts déployés (lorsque des défauts étaient signalés lors de la dernière phase avant la production) étaient considérables, car les développeurs devaient repasser par la phase de conception et de codage.
Cycle de vie du développement logiciel (SDLC) Avant le passage à gauche Test
Le déroulement traditionnel du SDLC était le suivant : Exigences -> ; Conception -> ; Codage -> ; Test.
Inconvénients des tests traditionnels
- Les tests se trouvent à l'extrême droite. L'identification d'un bogue à la dernière minute entraîne des coûts importants.
- Le temps nécessaire à la résolution du bogue et aux nouveaux tests avant la mise en production est considérable.
C'est ainsi qu'est née l'idée de déplacer la phase de test vers la gauche, ce qui a donné naissance au Shift Left Testing.
Suggestions de lecture => ; Shift Left Testing : un mantra secret pour la réussite des logiciels
Phases du test du décalage à gauche
Le Left Shift Testing a permis de passer avec succès de la détection des défauts à la prévention des défauts. Il a également permis au logiciel d'échouer rapidement et de corriger toutes les défaillances au plus tôt.
API Web
En termes généraux, une API Web peut être définie comme quelque chose qui prend la requête d'un système client vers un serveur Web et qui renvoie la réponse d'un serveur Web vers une machine cliente.
Comment fonctionne une API ?
Prenons l'exemple très courant de la réservation d'un vol sur www.makemytrip.com, un service de voyage en ligne qui regroupe les informations de plusieurs compagnies aériennes. Lorsque vous réservez un vol, vous entrez des informations telles que la date de départ/retour, la classe, etc. et vous cliquez sur le bouton "Rechercher".
Dans ce cas, l'application interagit avec les API de plusieurs compagnies aériennes et donne ainsi accès aux données de la compagnie aérienne.
Un autre exemple est www.trivago.com qui compare et répertorie les prix, la disponibilité, etc. de différents hôtels d'une ville donnée. Ce site web communique avec les API de plusieurs hôtels pour accéder à la base de données et répertorie les prix et la disponibilité sur leur site web.
Ainsi, une API Web peut être définie comme "une interface qui facilite la communication entre une machine cliente et le serveur Web".
Services Web
Les services Web sont (comme les API Web) des services qui passent d'une machine à l'autre, mais la principale différence entre les API et les services Web est que les services Web utilisent un réseau.
On peut dire que tous les services Web sont des API Web, mais que toutes les API Web ne sont pas des services Web (voir la dernière partie de l'article). Les services Web sont donc un sous-ensemble des API Web. Consultez le diagramme ci-dessous pour en savoir plus sur les API Web et les services Web.
API Web vs Services Web
Services Web et API Web
L'API Web et les services Web sont tous deux utilisés pour faciliter la communication entre le client et le serveur. La principale différence réside uniquement dans la manière dont ils communiquent.
Chacun d'entre eux nécessite un corps de requête acceptable dans une langue spécifique, des différences dans la fourniture d'une connexion sécurisée, la vitesse de communication avec le serveur et de réponse au client, etc.
Les différences entre les services Web et les API Web sont énumérées ci-dessous à titre de référence.
Service Web
- Les services web utilisent généralement le langage XML (Extensible Markup Language), ce qui signifie qu'ils sont plus sûrs.
- Les services Web sont plus sûrs, car les services Web et les API utilisent le protocole SSL (Secure Socket Layer) lors de la transmission des données, mais aussi le protocole WSS (Web Services Security).
- Le service Web est un sous-ensemble de l'API Web. Par exemple, Les services Web sont basés uniquement sur trois styles d'utilisation, à savoir SOAP, REST et XML-RPC.
- Les services Web ont toujours besoin d'un réseau pour fonctionner.
- Les services Web permettent d'utiliser un code unique pour différentes applications, ce qui signifie qu'un code plus générique est écrit pour différentes applications.
API Web
- Une API Web utilise généralement JSON (JavaScript Object Notation), ce qui signifie que l'API Web est plus rapide.
- L'API Web est plus rapide car JSON est léger, contrairement à XML.
- Les API Web sont le surensemble des services Web. Par exemple, Les trois styles de services Web sont également présents dans l'API Web, mais celle-ci utilise d'autres styles tels que JSON - RPC.
- L'API Web ne nécessite pas nécessairement un réseau pour fonctionner.
- L'API Web peut ou non prendre en charge l'interopérabilité en fonction de la nature du système ou de l'application.
Introduire les tests d'API dans votre organisation
Dans notre vie quotidienne, nous avons tous l'habitude d'interagir avec les applications au moyen d'API, mais nous ne pensons même pas aux processus d'arrière-plan qui pilotent la fonctionnalité sous-jacente.
Par exemple, Considérons que vous êtes en train de parcourir les produits sur Amazon.com et que vous voyez un produit/une affaire qui vous plaît vraiment et que vous souhaitez partager avec votre réseau Facebook.
Dès que vous cliquez sur l'icône Facebook dans la section de partage de la page et que vous saisissez les informations d'identification de votre compte Facebook pour partager, vous interagissez avec une API qui relie de manière transparente le site web d'Amazon à Facebook.
L'accent est mis sur les tests d'API
Avant d'en dire plus sur les tests d'API, examinons les raisons pour lesquelles les applications basées sur les API ont gagné en popularité ces derniers temps.
Plusieurs raisons poussent les entreprises à passer à des produits et applications basés sur des API, dont certaines sont énumérées ci-dessous à titre de référence.
#1) Les applications basées sur les API sont plus évolutives que les applications/logiciels traditionnels. Le rythme de développement du code est plus rapide et la même API peut répondre à un plus grand nombre de demandes sans qu'il soit nécessaire d'apporter des modifications majeures au code ou à l'infrastructure.
#2) Les équipes de développement n'ont pas besoin de recommencer à coder depuis le début chaque fois qu'elles commencent à travailler sur le développement d'une fonctionnalité ou d'une application. Les API réutilisent le plus souvent des fonctions, des bibliothèques, des procédures stockées, etc. existantes et reproductibles et, par conséquent, ce processus peut les rendre plus productives dans l'ensemble.
Par exemple, Si vous êtes un développeur travaillant sur un site de commerce électronique et que vous souhaitez ajouter Amazon comme processeur de paiement, vous n'avez pas besoin d'écrire le code à partir de zéro.
Il vous suffit de configurer l'intégration entre votre site web et l'API Amazon à l'aide de clés d'intégration et d'appeler l'API Amazon pour traiter les paiements lors de la validation de la commande.
#3) Les API permettent une intégration facile avec les autres systèmes, tant pour les applications autonomes prises en charge que pour les produits logiciels basés sur les API.
Par exemple Si vous souhaitez envoyer un chargement de Toronto à New York, vous vous rendez en ligne sur un site de fret ou de logistique bien connu et vous saisissez les informations demandées.
Après avoir fourni les informations obligatoires, lorsque vous cliquez sur le bouton Obtenir les tarifs - dans le back-end, ce site web logistique peut se connecter à plusieurs API et applications de transporteurs et de fournisseurs de services pour obtenir les tarifs dynamiques pour la combinaison de lieux d'origine et de destination.
Spectre complet de tests API
Le test des API ne se limite pas à l'envoi d'une requête à l'API et à l'analyse de la réponse pour en vérifier l'exactitude. Les API doivent être testées pour vérifier leurs performances sous différentes charges afin de détecter les vulnérabilités.
Discutons-en en détail.
(i) Essais fonctionnels
Les tests fonctionnels peuvent être une tâche difficile en raison de l'absence d'interface graphique.
Voyons en quoi l'approche des tests fonctionnels pour les API est différente de celle des applications basées sur l'interface graphique et nous discuterons également de quelques exemples à ce sujet.
a) La différence la plus évidente est qu'il n'y a pas d'interface graphique avec laquelle interagir. Les testeurs qui effectuent habituellement des tests fonctionnels basés sur l'interface graphique ont un peu plus de mal à passer aux tests d'applications sans interface graphique que ceux qui sont déjà familiarisés avec ce type d'interface.
Avant même de commencer à tester l'API, vous devrez tester et vérifier le processus d'authentification lui-même. La méthode d'authentification variera d'une API à l'autre et impliquera une sorte de clé ou de jeton pour l'authentification.
Si vous ne parvenez pas à vous connecter à l'API, les tests ne peuvent pas se poursuivre. Ce processus peut être considéré comme comparable à l'authentification de l'utilisateur dans les applications standard, où vous devez disposer d'informations d'identification valides pour vous connecter à l'application et l'utiliser.
b) Le test de la validation des champs ou des données d'entrée est très important lors du test des API. Si une interface basée sur un formulaire réel (GUI) était disponible, des validations de champs pourraient être mises en œuvre dans le front-end ou le back-end, garantissant ainsi qu'un utilisateur n'est pas autorisé à saisir des valeurs de champ non valides.
Par exemple, Si une application a besoin que le format de la date soit JJ/MM/AAAA, nous pouvons appliquer cette validation sur le formulaire de collecte d'informations pour garantir que l'application reçoit et traite une date valide.
Nous devons nous assurer que l'API est bien écrite et qu'elle est capable d'appliquer toutes ces validations, de faire la distinction entre les données valides et non valides et de renvoyer le code d'état et le message d'erreur de validation à l'utilisateur final par le biais d'une réponse.
c) Si un code d'état 200 (signifiant que tout va bien) est reçu comme réponse de l'API de test, mais que le texte de la réponse indique qu'une erreur a été rencontrée, il s'agit alors d'un défaut.
En outre, si le message d'erreur lui-même est incorrect, il peut être très trompeur pour le client final qui essaie de s'intégrer à cette API.
Dans la capture d'écran ci-dessous, l'utilisateur a saisi un poids non valide, supérieur aux 2267 kg acceptables. L'API répond par un code d'état et un message d'erreur. Cependant, le message d'erreur mentionne incorrectement les unités de poids en livres au lieu de KG. Il s'agit d'un défaut qui peut troubler le client final.
(ii) Tests de charge et de performance
Les API sont conçues pour être évolutives.
Les tests de charge et de performance sont donc essentiels, surtout si le système en cours de conception est appelé à traiter des milliers de demandes par minute ou par heure, selon les besoins. La réalisation régulière de tests de charge et de performance sur l'API peut aider à évaluer les performances, les charges maximales et le point de rupture.
Ces données sont utiles lorsqu'il s'agit de planifier l'extension d'une application. Le fait de disposer de ces informations permet d'étayer les décisions et la planification, en particulier si l'organisation prévoit d'augmenter le nombre de ses clients, ce qui se traduirait par une augmentation du nombre de demandes entrantes.
Comment introduire les tests d'API dans votre organisation
Le processus d'introduction des tests API dans une organisation est similaire au processus utilisé pour la mise en œuvre ou le déploiement de tout autre outil ou cadre de test.
Le tableau ci-dessous résume les principales étapes ainsi que les résultats escomptés pour chacune d'entre elles.
Phase | Étape | Résultats attendus |
---|---|---|
Sélection des outils | Recueillir les besoins et identifier les contraintes | Comprendre les exigences de la recherche sur le marché d'un outil de test API approprié. Par exemple Quel type d'API est testé - SOAP ou REST ? Devons-nous recruter des testeurs pour ce rôle ou former des testeurs existants ? Quels types de tests seront effectués - tests fonctionnels, tests de performance, etc. Quel est le budget prévu pour la mise en œuvre ? |
Évaluer les outils disponibles | Comparez les outils disponibles et présélectionnez 1 ou 2 outils qui répondent le mieux à vos besoins. | |
Preuve de concept | Mettre en œuvre un sous-ensemble de tests avec l'outil présélectionné. Présenter les résultats aux parties prenantes. Finaliser l'outil à mettre en œuvre. | |
Mise en œuvre | Pour commencer | Selon l'outil choisi, vous devrez installer l'outil requis sur un PC, une machine virtuelle ou un serveur. Si l'outil choisi est basé sur un abonnement, créer les comptes d'équipe nécessaires. Former l'équipe si nécessaire. |
Partir | Créer des tests Exécuter les tests Signaler les défauts |
Défis courants et moyens de les atténuer
Examinons quelques-uns des défis courants auxquels les équipes d'assurance qualité sont confrontées lorsqu'elles tentent de mettre en œuvre un cadre de test d'API dans une organisation.
#1) Choisir le bon outil
La sélection de l'outil adéquat est le défi le plus courant. Il existe plusieurs outils de test de l'API sur le marché.
Il peut sembler très attrayant de mettre en œuvre l'outil le plus récent et le plus cher disponible sur le marché, mais s'il n'apporte pas les résultats escomptés, cet outil n'est d'aucune utilité.
Par conséquent, choisissez toujours l'outil qui répond aux exigences "indispensables" en fonction de vos besoins organisationnels.
Voici un exemple de matrice d'évaluation des outils API disponibles
Outil | Tarification | Notes |
---|---|---|
L'interface utilisateur en mode savon | Version gratuite disponible pour SoapUI Open Source (tests fonctionnels) | * REST, SOAP et autres protocoles API et IoT courants. * Inclus dans la version gratuite Tests ad hoc SOAP et REST Assertion de message Création de tests par glisser-déposer Journaux des tests Configuration du test Test à partir d'enregistrements Rapport de l'unité. * La liste complète des caractéristiques peut être consultée sur leur site web. |
Facteur | L'application gratuite du facteur est disponible | * Les plus utilisés pour REST. * Les caractéristiques peuvent être consultées sur leur site web. |
Parasoft | Il s'agit d'un outil payant, qui nécessite l'achat d'une licence et une installation avant de pouvoir être utilisé. | * Tests complets de l'API : tests fonctionnels, de charge, de sécurité, gestion des données de test. |
vREST | En fonction du nombre d'utilisateurs | * Tests automatisés de l'API REST. * Enregistrement et relecture. * Supprime la dépendance entre le frontend et le backend en utilisant des API fictives. * Validation puissante des réponses. * Fonctionne pour les applications de test déployées sur localhost/intranet/internet. * Intégration JIRA, intégration Jenkins Importations de Swagger, Postman. |
HttpMaster | Édition Express : Téléchargement gratuit Version professionnelle : en fonction du nombre d'utilisateurs | * Aide à tester les sites web et les API. * Parmi les autres caractéristiques, citons la possibilité de définir des paramètres globaux, qui permet à l'utilisateur de créer des contrôles pour la validation des réponses aux données en utilisant le large éventail de types de validation qu'il prend en charge. |
Runscope | En fonction du nombre d'utilisateurs et des types de plans | * Pour la surveillance et le test des API. * Peut être utilisé pour la validation des données afin de s'assurer que les données renvoyées sont correctes. * Contient des fonctionnalités de suivi et de notification en cas d'échec d'une transaction API (si votre application nécessite une validation de paiement, cet outil peut s'avérer être un bon choix). |
LoadFocus | En fonction du nombre d'utilisateurs et des types de plans | * Peut être utilisé pour les tests de charge de l'API - permet d'exécuter quelques tests pour déterminer le nombre d'utilisateurs qu'une API peut prendre en charge. * Simple d'utilisation - permet d'exécuter des tests dans le navigateur. |
PingAPI | Gratuit pour 1 projet (1 000 demandes) | * Bénéfique pour les tests d'API automatisés et la surveillance. |
#2) Spécifications de test manquantes
En tant que testeurs, nous devons connaître les résultats attendus pour tester efficacement une application, ce qui constitue souvent un défi, car pour connaître les résultats attendus, nous devons avoir des exigences claires et précises, ce qui n'est pas le cas.
Par exemple Pour ce faire, il convient de prendre en considération les exigences énoncées ci-dessous :
"L'application ne doit accepter qu'une date d'expédition valide et toutes les exigences non valides doivent être rejetées.
Ces exigences manquent de détails clés et sont très ambiguës - comment définissons-nous une date valide ? Qu'en est-il du format ? Renvoyons-nous un message de rejet à l'utilisateur final, etc.
Exemple d'exigences claires :
1) L'application ne doit accepter qu'une date d'expédition valide.
La date d'expédition est considérée comme valide si elle est
- Pas dans le passé
- Supérieure ou égale à la date du jour
- Format acceptable : JJ/MM/AAAA
2)
Code d'état de la réponse = 200
Message : OK
3) La date d'expédition qui ne répond pas aux critères ci-dessus doit être considérée comme non valide. Si un client envoie une date d'expédition non valide, le système doit répondre par le(s) message(s) d'erreur suivant(s) :
3.1
Réponse Code d'état NOT 200
Erreur : La date d'expédition fournie n'est pas valide ; veuillez vous assurer que la date est au format JJ/MM/AAAA.
3.2
Réponse Code d'état NOT 200
Erreur : La date d'expédition fournie est dépassée
#3) Courbe d'apprentissage
Comme indiqué précédemment, l'approche des tests d'API est différente de celle suivie pour les tests d'applications basées sur l'interface graphique.
Si vous engagez des spécialistes en interne ou des consultants pour les tests d'API, la courbe d'apprentissage de l'approche ou de l'outil de test d'API peut être minime. Toute courbe d'apprentissage, dans ce cas, serait associée à l'acquisition de connaissances sur le produit ou l'application.
Si un membre de l'équipe est chargé d'apprendre à tester l'API, la courbe d'apprentissage peut être moyenne à élevée, en fonction de l'outil choisi, tout comme la modification de l'approche du test. La courbe d'apprentissage du produit ou de l'application elle-même peut être faible à moyenne, selon que le testeur a déjà testé l'application auparavant ou non.
#4) L'ensemble des compétences existantes
Ceci est directement lié au point précédent concernant la courbe d'apprentissage.
Si un testeur passe d'un test basé sur une interface graphique à un autre, il devra changer d'approche et apprendre le nouvel outil ou le nouveau cadre de travail, le cas échéant. Par exemple Si l'API accepte les demandes au format JSON, le testeur devra apprendre ce qu'est JSON pour commencer à créer les tests.
Étude de cas
Tâche
L'équipe d'assurance qualité a été invitée à fournir un plan de couverture des tests afin de s'assurer qu'elle est prête à accueillir les tests API en plus des tests basés sur l'interface graphique habituelle.
Défis
- Aucun des autres produits logiciels n'avait d'architecture basée sur l'API, de sorte que pour adapter les tests à cette tâche, l'équipe a dû établir le processus de test de l'API à partir de zéro. Cela signifie que les outils ont dû être évalués, présélectionnés, finalisés et que l'équipe a dû être formée pour les tests.
- Aucun budget supplémentaire n'a été alloué à l'acquisition et à la mise en œuvre de l'outil, ce qui signifie que l'équipe a dû choisir un outil de test d'API gratuit ou à source ouverte et qu'une personne de l'équipe existante a dû être formée à cette tâche.
- Il n'y avait pas d'exigences concernant les champs de l'API et la validation des données. Les exigences étaient les suivantes : "doit fonctionner de la même manière que l'application GUI correspondante".
L'approche suivie par l'équipe pour atténuer les risques et contourner les difficultés
- L'équipe d'assurance qualité a travaillé avec l'équipe du projet pour identifier les exigences suivantes :
- Type d'API (REST/SOAP) : REST
- Tests requis (fonctionnels, de charge, de sécurité) : Essais fonctionnels uniquement
- Tests automatisés requis (Oui/Non) : Facultatif pour l'instant
- Rapports d'essais (Oui/Non) : Exigée
- L'équipe d'assurance qualité a évalué les outils de test d'API disponibles sur la base des exigences incontournables. Postman API Tool a été retenu comme l'outil de leur choix car il était gratuit et facile à utiliser, minimisant ainsi la courbe d'apprentissage, et avait le potentiel d'automatiser les tests, et était fourni avec de bons rapports intégrés.
- Le même testeur qui a testé l'application a été formé à l'utilisation de Postman pour créer des tests initiaux, ce qui a permis d'éliminer toute lacune dans la connaissance du produit.
- Pour répondre aux exigences manquantes, l'équipe de projet a élaboré la documentation de haut niveau sur le terrain à l'aide de Swagger, ce qui a toutefois laissé des lacunes en termes de formats de données acceptables, ce qui a été abordé avec l'équipe de projet et les formats attendus ont été convenus et documentés.
Conclusion
Les applications basées sur les API ont gagné en popularité ces derniers temps. Ces applications sont plus évolutives que les applications/logiciels traditionnels et permettent une intégration plus facile avec d'autres API ou applications.
Ce tutoriel sur les tests d'API explique en détail les tests d'API, les tests Shift Left, les services Web et les API Web. Nous avons également exploré les différences entre les services Web et les API Web à l'aide d'exemples.
Dans la deuxième partie du tutoriel, nous avons abordé l'ensemble du spectre des tests d'API, la manière d'introduire les tests d'API dans votre organisation et certains défis courants dans ce processus, ainsi que les solutions pour y remédier.
Consultez notre prochain tutoriel pour en savoir plus sur les services Web avec des exemples !
Prochain tutoriel