Automatisation et tests

Une fois qu'une requête fonctionne, faites-la travailler pour vous. Echo automatise les tâches répétitives : exécuter des suites de tests, enchaîner les appels, simuler des dépendances et vérifier une API selon un planning.

Exécutez une collection entière

L'exécuteur de collections parcourt une collection de bout en bout :

Choisissez la collection et le nombre d'itérations.
Ajoutez une pause entre les requêtes si l'API cible en a besoin.
Activez l'arrêt sur erreur si un échec doit interrompre l'exécution.
Lancez l'exécution et suivez les résultats en direct.

L'exécuteur permet de vérifier une API après un déploiement ou de reproduire une erreur sur plusieurs itérations. Chargez un fichier CSV avec des en-têtes de colonnes ou un tableau JSON d'objets pour exécuter la collection avec différentes données. Chaque ligne fournit les valeurs d'une itération.

Une fois l'exécution terminée, exportez un rapport JUnit XML pour vos outils de test ou un rapport HTML à lire et à partager. L'historique conserve le nom du fichier de données et le nombre de lignes pour vous aider à retrouver les conditions de l'exécution.

Enchaînez les requêtes sans code

Les chaînes de requêtes sont déclaratives et ne nécessitent aucun script. Chaque chaîne exécute ses étapes dans l'ordre, extrait des valeurs d'une réponse avec JSONPath et les transmet aux étapes suivantes. Se connecter, récupérer le jeton, créer une ressource et la vérifier peuvent faire partie d'une même chaîne.

Les étapes peuvent aussi comporter des conditions afin que la chaîne suive différents chemins selon la réponse réelle de l'API.

Choisissez où votre mock s'exécute

Lorsqu'une dépendance réelle n'est pas encore prête, un mock permet à l'équipe frontend de continuer à travailler et de tester les délais d'attente et les codes d'erreur. Echo identifie les routes par des motifs de chemin, accepte des réponses statiques ou fondées sur un contrat et permet de définir le délai et le statut de chaque route.

Les mocks sur le bureau interceptent les requêtes envoyées dans Echo avec n'importe quel forfait, Free compris. Pour obtenir une URL qu'une autre application ou personne peut appeler, publiez un mock synchronisé depuis le panneau d'hébergement public de Maestro. Publier fait partie d'Echo Pro et Pro AI ; un mock d'équipe nécessite aussi Echo/ManageHosting, tandis que vous pouvez publier dans votre propre espace en tant que propriétaire. Le mock publié continue à répondre sans l'application de bureau ouverte. Consultez l'hébergement public de mocks pour les étapes, l'accès par URL et les contrôles opérationnels.

Pour utiliser des règles dans votre application .NET, utilisez Mock.Client ou Mock.Server et une clé d'application avec ServeMocks. Cette voie est distincte de l'URL publique, mais la récupération des règles et la création des clés exigent aussi Echo Pro ou Pro AI. Le mock n'a pas besoin d'être publié sur le service public.

Les mocks du bureau prennent aussi en charge les réponses gRPC et les séquences de messages WebSocket. Ils répondent aux requêtes effectuées dans Echo. Ils n'ouvrent aucun port réseau et ne fournissent pas d'adresse gRPC ou WebSocket à une autre application ; l'hébergement public de mocks répond aux requêtes HTTP.

Vérifiez aussi les contrats

Un contrat décrit la structure des données qu'une application fournit ou consomme. Publiez des versions et comparez leur compatibilité dans le sens pertinent pour votre application. Les paquets Contracts et Testing relient la publication et la validation à l'automatisation .NET.

Planifiez des exécutions

Choisissez où chaque tâche planifiée s'exécute. Les tâches du bureau nécessitent qu'Echo reste ouvert. Les tâches hébergées s'exécutent sur les serveurs de Gapfy et continuent après la fermeture de l'application ; elles nécessitent une offre Echo payante et l'autorisation d'utiliser cette fonction.

Le mode hébergé accepte les requêtes HTTP et les opérations query et mutation de GraphQL, avec au moins cinq minutes entre les exécutions. Choisissez l'environnement, enregistrez le planning et vérifiez qu'Echo confirme sa prise en compte sur le serveur. Synchroniser un planning du bureau ne change pas son mode d'exécution. Maestro affiche les résultats des tâches hébergées et les résumés synchronisés des exécutions de collections.

Utilisez des scripts au besoin

Pour les cas qui dépassent les chaînes déclaratives, Echo prend en charge JavaScript avant et après la requête avec l'API pm.*, y compris les assertions. Si vous avez déjà écrit des scripts Postman, l'approche vous sera familière : vérifiez les codes de statut, les corps et les en-têtes des réponses et faites échouer l'exécution lorsque le résultat ne correspond pas aux attentes.

Commencez par les chaînes, plus faciles à lire et à maintenir, et utilisez des scripts lorsque vous avez besoin d'une logique personnalisée.