Mocks distants

Un mock distant fournit à votre équipe un endpoint HTTP avant que la dépendance réelle soit prête. Utilisez-le pour développer un frontend, préparer une démonstration partagée ou provoquer des erreurs et des délais. Echo peut exécuter un mock localement sur le bureau ou le publier sur le service hébergé à mock.gapfy.io. Un mock hébergé continue à répondre sans laisser l'application de bureau ouverte.

Les mocks locaux interceptent les requêtes envoyées par Echo lui-même ; ils n'ouvrent pas de serveur HTTP pour une autre application.

Choisir où le mock s'exécute

  • Bureau local : gardez les requêtes sur votre machine pendant la création et les essais.
  • Mock hébergé : donnez à une autre machine une URL qu'elle peut appeler directement.
  • Dans votre application .NET : utilisez Mock.Client ou Mock.Server avec des règles récupérées par une clé d'application. Cette option est distincte de l'URL publique hébergée.

Publier votre premier mock

  1. Ouvrez Mocks dans Maestro et sélectionnez l'espace de travail propriétaire du mock.
  2. Créez un serveur et ajoutez une route avec une méthode HTTP, un motif de chemin, un statut et une réponse. Choisissez une réponse statique ou un contrat. Vous pouvez aussi partir d'un mock enregistré et synchronisé depuis le bureau.
  3. Ouvrez le panneau d'hébergement du serveur et activez l'hébergement public. Ce changement nécessite les autorisations d'administration de l'espace de travail acceptées par le panneau.
  4. Copiez l'URL de base exacte affichée par le panneau et ajoutez le chemin de votre route. Le nom d'hôte seul n'est pas un endpoint de mock.
  5. Appelez la route depuis l'application consommatrice et vérifiez la réponse, y compris X-Echo-Mock.

Les contrats permettent de générer des réponses structurées et de conserver des versions. Les réponses statiques conviennent lorsqu'un corps exact est nécessaire.

Partager en connaissance de cause

Toute personne connaissant l'URL publique peut appeler ses routes. Elle n'est pas protégée par une clé d'application eck_. Utilisez des données fictives, excluez les identifiants des corps et des en-têtes et partagez l'URL avec les seuls destinataires prévus.

Le panneau permet de désactiver l'hébergement ou de renouveler l'identifiant public pour obtenir une nouvelle URL. Il faut alors mettre à jour les clients. Les opérateurs de la plateforme peuvent suspendre l'hébergement ou appliquer un blocage global ; le propriétaire ne peut pas activer un mock suspendu avant la levée de la suspension. Actualisez le panneau pour consulter son état.

Utiliser les règles dans votre application

Applications et clés explique l'autorisation distincte ServeMocks, utilisée par le flux de règles .NET. Choisissez cette voie si votre application doit servir ou intercepter des requêtes avec les règles Echo, plutôt qu'appeler l'URL hébergée.