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 :

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

C'est un moyen rapide de vérifier une API après un déploiement ou de reproduire une erreur intermittente au fil des itérations.

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.

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

Les exécutions planifiées avec cron vérifient l'API pendant qu'Echo est ouvert. Définissez le planning et Echo vous avertit en cas d'échec, pour vous permettre de repérer un endpoint défaillant avant vos utilisateurs. Les plannings se synchronisent entre vos appareils connectés, mais cette synchronisation ne les transforme pas en tâches hébergées.

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.

Étapes suivantes