Alojamiento público de mocks

Un mock publicado da a tu equipo un endpoint HTTP antes de que la dependencia real esté lista. Úsalo para desarrollar un frontend, preparar una demostración compartida o probar errores y retrasos de forma deliberada. Echo puede interceptar peticiones en el escritorio o publicar el mock en el servicio público mock.gapfy.io. El mock publicado sigue respondiendo con el escritorio cerrado.

Los mocks en el escritorio interceptan peticiones enviadas por el propio Echo; no abren un servidor HTTP para otra aplicación.

Elige dónde se ejecuta

  • Mocks en el escritorio: mantén las peticiones en tu equipo mientras creas y experimentas. Están incluidos en todos los planes de Echo, incluido el Free.
  • Alojamiento público de mocks: proporciona a otro equipo una URL que pueda llamar directamente. Publicar forma parte de Echo Pro y Pro AI.
  • Dentro de tu aplicación .NET: usa Mock.Client o Mock.Server con reglas obtenidas mediante una clave de aplicación. No necesitas publicar el mock en el servicio público, pero obtener esas reglas requiere el mismo plan de pago.

Publica tu primer mock

  1. Abre Mocks en Maestro y selecciona el espacio de trabajo al que pertenece.
  2. Crea un servidor y añade una ruta con método HTTP, patrón de ruta, estado y respuesta. Elige una respuesta estática o un contrato. También puedes partir de un mock guardado y sincronizado desde el escritorio.
  3. Abre el panel de alojamiento público del servidor y activa la publicación. En Free, el panel muestra que el alojamiento público no está incluido en el plan y no permite activar ni renovar el identificador público; pide a un administrador de la organización que cambie el plan en Facturación de Maestro. Publicar requiere Echo Pro o Pro AI. Echo Pro AI aparece como próximo y todavía no se puede contratar. Con un plan de pago, publicas un mock de tu propio espacio por ser su propietario; publicar un mock de equipo requiere Echo/ManageHosting, permiso concedido por defecto al administrador de la organización.
  4. Copia la URL base exacta que muestra el panel y añade la ruta. El nombre del host por sí solo no es un endpoint de mock.
  5. Llama a la ruta desde la aplicación consumidora y comprueba la respuesta, incluido X-Echo-Mock.

Los contratos permiten generar respuestas estructuradas y conservar versiones. Las respuestas estáticas sirven cuando necesitas un cuerpo exacto.

Límites del alojamiento público

Echo Pro y Pro AI permiten publicar hasta 25 mocks simultáneamente por organización. Es un límite estricto: si ya hay 25 publicados, debes desactivar uno antes de publicar otro. El servicio mide 50 000 peticiones servidas al mes por asiento, pero superar esa cifra no hace que se rechacen peticiones por la medición mensual. Free no permite publicar; sus dos cuotas de alojamiento público son cero.

Por separado, el servicio admite por defecto 300 peticiones por minuto y por mock. Si se supera ese límite operativo, responde 429. No confundas esa protección con la medición mensual.

Comparte de forma consciente

Cualquiera que conozca la URL pública puede llamar a sus rutas. No está protegida por una clave de aplicación eck_. Usa datos inventados, evita credenciales en cuerpos y cabeceras y comparte la URL solo con sus destinatarios.

El panel permite desactivar el alojamiento público o cambiar el identificador público y obtener una nueva URL. Tendrás que actualizar los clientes. Los operadores de la plataforma pueden suspender manualmente un mock o aplicar un bloqueo global. La suspensión manual permanece hasta que un operador la retire; un bloqueo global también puede caducar. Actualiza el panel para consultar su estado.

Si la organización pierde el plan de pago después de cualquier periodo de gracia, el mock publicado no se elimina: conserva su URL y su identificador público, pero queda suspendido. Quien llame recibe 503 con el código mock-server-suspended y el encabezado Retry-After; el motivo registrado en el panel no se muestra al llamador. Cuando vuelve a estar vigente un plan que incluye alojamiento público, esa suspensión se levanta sola y la misma URL responde sin republicar. El cambio puede tardar hasta unos cinco minutos en reflejarse. Una suspensión manual impuesta por la plataforma, en cambio, requiere que intervenga un operador.

Lleva las reglas a tu aplicación

Aplicaciones y claves explica el scope ServeMocks, usado por las reglas para .NET. Elige esta vía cuando tu aplicación deba servir o interceptar peticiones con reglas de Echo en lugar de llamar a la URL pública. Obtener las reglas también requiere Echo Pro o Pro AI, aunque el mock no esté publicado en el servicio público.