Hébergement public de mocks

Un mock publié 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 intercepter des requêtes sur le bureau ou publier le mock sur le service public mock.gapfy.io. Le mock publié continue à répondre sans laisser l'application de bureau ouverte.

Les mocks sur le bureau 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

  • Mocks sur le bureau : gardez les requêtes sur votre machine pendant la création et les essais. Ils sont compris dans tous les forfaits Echo, Free compris.
  • Hébergement public de mocks : donnez à une autre machine une URL qu'elle peut appeler directement. Publier fait partie d'Echo Pro et Pro AI.
  • Dans votre application .NET : utilisez Mock.Client ou Mock.Server avec des règles récupérées par une clé d'application. Le mock n'a pas besoin d'être publié sur le service public, mais récupérer ces règles nécessite le même forfait payant.

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 public du serveur et activez la publication. Dans Free, le panneau indique que l'hébergement public ne fait pas partie du forfait et ne permet ni d'activer ni de renouveler l'identifiant public ; demandez à un administrateur de l'organisation de changer de forfait dans la Facturation de Maestro. Publier nécessite Echo Pro ou Pro AI. Echo Pro AI est annoncé pour bientôt et ne peut pas encore être souscrit. Avec un forfait payant, vous publiez un mock de votre propre espace parce que vous en êtes propriétaire ; publier un mock d'équipe nécessite Echo/ManageHosting, autorisation attribuée par défaut à l'administrateur de l'organisation.
  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.

Limites de l'hébergement public

Echo Pro et Pro AI permettent de publier jusqu'à 25 mocks simultanément par organisation. Cette limite est stricte : si 25 mocks sont déjà publiés, vous devez en désactiver un avant d'en publier un autre. Le service mesure 50 000 requêtes servies par mois et par place, mais dépasser ce nombre ne provoque pas le refus de requêtes au titre de cette mesure mensuelle. Free ne permet pas de publier ; ses deux quotas d'hébergement public sont à zéro.

Séparément, le service admet par défaut 300 requêtes par minute et par mock. Si cette limite opérationnelle est dépassée, il répond 429. Ne la confondez pas avec la mesure mensuelle.

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 public 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 manuellement un mock ou appliquer un blocage global. La suspension manuelle reste en vigueur jusqu'à ce qu'un opérateur la lève ; un blocage global peut aussi expirer. Actualisez le panneau pour consulter son état.

Si l'organisation perd son forfait payant après toute période de grâce, le mock publié n'est pas supprimé : il conserve son URL et son identifiant public, mais il est suspendu. Les appels reçoivent 503 avec le code mock-server-suspended et l'en-tête Retry-After ; le motif enregistré dans le panneau n'est pas montré aux appelants. Dès qu'un forfait comprenant l'hébergement public est de nouveau en vigueur, cette suspension se lève seule et la même URL répond sans nouvelle publication. Le changement peut prendre jusqu'à environ cinq minutes. Une suspension manuelle imposée par la plateforme, en revanche, exige l'intervention d'un opérateur.

Utiliser les règles dans votre application

Applications et clés explique le scope ServeMocks, utilisé par les règles pour .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 publique. Récupérer ces règles nécessite aussi Echo Pro ou Pro AI, même si le mock n'est pas publié sur le service public.