```html
Apidog est une plateforme de collaboration et de développement d'API qui aide les équipes backend, frontend et QA à travailler plus efficacement. Pour les ingénieurs QA, Apidog offre une gamme de fonctionnalités de test, notamment les tests unitaires, les tests d'intégration, les tests basés sur les données, les tests de performance, les tests de régression, l'intégration continue/déploiement continu (CI/CD) et la surveillance planifiée.
Passons en revue le flux de travail complet pour les ingénieurs QA utilisant Apidog, en commençant par les bases.
Préparation initiale
La première étape pour commencer les tests d'API est d'obtenir une documentation API détaillée. Apidog facilite cela en vous permettant d'importer directement la documentation API existante. Cela élimine le besoin de saisir chaque point de terminaison manuellement. Allez simplement dans Project Settings -> Import Data et choisissez le format de données approprié à importer.
Tests unitaires
Les tests unitaires sont une partie cruciale du processus de test. Ils garantissent que chaque API fonctionne comme prévu dans différentes conditions. Les ingénieurs QA rédigent des cas de test détaillés pour couvrir divers scénarios, tels que les cas normaux, exceptionnels et limites. Cela garantit que l'API gère toutes les entrées possibles.
Par exemple, le point de terminaison "Query Pet Details" nécessite un ID d'animal de compagnie en tant que paramètre pour récupérer les détails de l'animal. Les ingénieurs QA peuvent saisir petId=123 sur la page "Run" d'Apidog et envoyer la requête. Ensuite, ils peuvent vérifier si les détails corrects de l'animal sont renvoyés.
Pour automatiser le test, des assertions peuvent être ajoutées dans les post-processeurs. Ces assertions vérifient si l'ID de l'animal correct apparaît dans la réponse sous le champ data. En utilisant l'expression JSONPath $.data.id et en définissant l'assertion sur Exists, l'ID de l'animal peut être extrait et validé automatiquement.
Vous pouvez également extraire l'assertion directement de la réponse renvoyée.
Une fois ces étapes terminées, le cas de test peut être enregistré. Des cas de test normaux et anormaux supplémentaires peuvent être créés selon les besoins, tels que "Animaux de compagnie disponibles à la vente", "Animaux de compagnie vendus", "Enregistrement non trouvé" et "Format d'ID incorrect". Ces cas de test enregistrés peuvent être exécutés rapidement et facilement lors de futurs tests de régression pour vérifier la stabilité des fonctionnalités de base.
Tests d'intégration
Tester des API individuelles est important, mais les applications réelles nécessitent souvent que plusieurs API fonctionnent ensemble. Les tests d'intégration garantissent que ces API interagissent correctement. Ils simulent les actions réelles des utilisateurs et testent l'échange de données et le flux de travail entre les API.
Par exemple, dans un processus d'achat d'animaux de compagnie, les utilisateurs peuvent parcourir des listes d'animaux de compagnie, ajouter des animaux de compagnie au panier, passer une commande, effectuer un paiement et afficher les détails de la commande. Les ingénieurs QA peuvent créer un scénario de test dans Apidog, en ajoutant des cas de test pour chaque point de terminaison impliqué dans le processus.
Le transfert de données entre les points de terminaison est crucial pour garantir que le processus de test est terminé. Prenons l'exemple du flux d'achat d'animaux de compagnie. Les ingénieurs QA peuvent transmettre l'ID de la commande entre les étapes de deux manières :
- Méthode 1 : Après avoir exécuté le point de terminaison "Créer une commande", enregistrez l'ID de commande généré en tant que variable et utilisez-le dans les points de terminaison de paiement et d'interrogation de commande suivants.
- Méthode 2 : Utilisez directement la valeur de retour du point de terminaison "Créer une commande" dans les points de terminaison de paiement et d'interrogation de commande (cette méthode est plus simple et recommandée).
Pour les opérations par lots, comme l'ajout de plusieurs animaux de compagnie au panier, une boucle ForEach peut être ajoutée. Définissez le tableau de boucles sur la liste des animaux de compagnie.
L'ID de l'animal de compagnie sera automatiquement inséré, ce qui facilitera les opérations en masse.
Après avoir tout configuré, exécutez le scénario de test. Cela générera un rapport de test détaillé. Les ingénieurs QA peuvent ensuite rapidement trouver et corriger les problèmes.
Tests basés sur les données
Dans certains cas, le même point de terminaison doit être testé avec plusieurs ensembles de données. La fonctionnalité de test basée sur les données d'Apidog aide à cela. Les ingénieurs QA peuvent importer un fichier CSV contenant différents ensembles de données. Ces ensembles peuvent ensuite être utilisés dans le scénario de test pour exécuter les tests automatiquement.
Voici comment cela fonctionne : les ingénieurs QA créent un nouveau scénario de test, ajoutent le point de terminaison "Créer des informations sur l'animal de compagnie" et importent le fichier CSV dans les Test Data. Chaque ligne (la première ligne étant le nom de la variable) du fichier CSV représente un ensemble de données qui peut être utilisé dans la requête API.
Référez-vous à ces variables dans le corps JSON de la requête du point de terminaison pour mapper les données du fichier CSV.
Sélectionnez les données de test et l'environnement appropriés, puis exécutez le test. Apidog exécutera automatiquement les cas de point de terminaison pour chaque ensemble de données, générant l'état d'exécution et les rapports pour chaque tour.
En automatisant les tests en masse de cette manière, Apidog améliore considérablement l'efficacité et la précision du processus de test.
Tests de performance
Une fois que la fonctionnalité de base d'un point de terminaison est validée, l'étape suivante est le test de performance. Cela vérifie comment le système fonctionne sous un trafic intense. Apidog fournit des outils de test de performance qui simulent plusieurs utilisateurs virtuels pour tester la réponse du système.
Par exemple, dans un scénario de commande, les ingénieurs QA peuvent définir le nombre d'utilisateurs virtuels (par exemple, 10), la durée du test et le temps de montée en charge (par exemple, 1 minute). Pendant le test, Apidog génère des graphiques en temps réel montrant des mesures clés telles que les requêtes par seconde, le temps de réponse du serveur et les taux d'erreur. Cela aide les ingénieurs QA à identifier les goulots d'étranglement des performances et à optimiser en conséquence.
Tests de régression
Au fur et à mesure que les systèmes évoluent, de nouvelles fonctionnalités peuvent affecter les fonctionnalités existantes. Les tests de régression garantissent que les nouvelles mises à jour ne cassent pas les fonctionnalités de base. Dans Apidog, les ingénieurs QA peuvent créer un dossier de tests de régression et ajouter des scénarios de test clés. Avant chaque version, ils peuvent exécuter ces tests en masse pour s'assurer que tout fonctionne comme prévu.
Intégration CI/CD
Dans les flux de travail de développement modernes, l'intégration continue (CI) et le déploiement continu (CD) sont cruciaux pour maintenir des cycles de publication rapides et un code de haute qualité. Apidog s'intègre de manière transparente aux outils CI/CD comme Jenkins, permettant aux tests automatisés de s'exécuter dans le cadre du pipeline de construction.
Les ingénieurs QA peuvent accéder à la page CI/CD dans un scénario de test spécifique, sélectionner l'environnement et les données de test appropriés, et activer les notifications pour les résultats des tests (prend en charge diverses méthodes de notification telles que Email, Slack, Webhook et Jenkins, etc.). Ensuite, sélectionnez l'outil CI/CD correspondant, copiez la commande générée et configurez-la dans Jenkins ou un autre outil de construction.
Il est important de générer et de configurer le Access Token pendant le processus d'intégration pour garantir une authentification et une communication fluides avec Jenkins. Une fois configuré, Apidog exécutera automatiquement les tests chaque fois qu'une construction est déclenchée et enverra les résultats des tests à l'équipe via la méthode de notification sélectionnée, améliorant ainsi l'efficacité de la collaboration.
Tâches planifiées pour les tests d'API
Parfois, il est nécessaire d'exécuter des tests régulièrement pour s'assurer que le système reste stable. La fonctionnalité de tâches planifiées d'Apidog permet aux ingénieurs QA d'automatiser ce processus. Ils peuvent planifier l'exécution des tests à des heures spécifiques et obtenir des notifications sur les résultats.
Avant d'utiliser cette fonctionnalité, les ingénieurs QA doivent installer le Runner d'Apidog sur le serveur. Cela garantit que les tâches planifiées peuvent s'exécuter indépendamment sur le serveur sans dépendre de l'ordinateur local. Après l'installation, les ingénieurs QA peuvent créer une nouvelle tâche planifiée, sélectionner le scénario de test, définir le mode d'exécution et le serveur, et activer les notifications.
Après l'exécution de la tâche, Apidog enregistre les résultats et les envoie à l'équipe, ce qui permet de repérer et de corriger rapidement les problèmes.
Principaux points à retenir
Apidog fournit une suite complète de fonctionnalités qui rationalisent considérablement le cycle de vie des tests d'API, de la préparation initiale à la surveillance continue. Grâce à des capacités robustes en matière de tests unitaires, d'intégration, basés sur les données, de performance, de régression et CI/CD, ainsi que de tâches planifiées, Apidog garantit des tests d'API efficaces, fiables et évolutifs. En intégrant Apidog dans vos flux de travail de test, les équipes peuvent gagner du temps, réduire les erreurs et fournir des API de haute qualité plus rapidement, ce qui conduit à une stabilité et des performances du système améliorées.
```
