Tabla de contenido

¿Alguna vez has tenido que esperar a que el equipo de backend termine una API para poder avanzar con el frontend? O ¿necesitas probar una integración pero el servicio externo tiene límites de peticiones? Las mock APIs son la solución a ese problema.

¿Para qué sirven las mock APIs?

En una arquitectura moderna donde frontend y backend están separados, el desarrollo suele ocurrir en paralelo. El problema es que el frontend necesita datos del backend para avanzar, y viceversa.

Las mock APIs (APIs simuladas) te permiten crear un servidor local que imita el comportamiento de una API real, con las respuestas que tú defines. Con esto puedes:

  • Desarrollar el frontend sin esperar al backend
  • Probar casos de error que son difíciles de reproducir en producción
  • Hacer demos a clientes sin exponer datos reales
  • Correr pruebas automatizadas sin depender de servicios externos

¿Para qué sirven las mock APIs?

En una arquitectura moderna donde frontend y backend están separados, el desarrollo suele ocurrir en paralelo. El problema es que el frontend necesita datos del backend para avanzar, y viceversa.

Las mock APIs (APIs simuladas) te permiten crear un servidor local que imita el comportamiento de una API real, con las respuestas que tú defines. Con esto puedes:

  • Desarrollar el frontend sin esperar al backend
  • Probar casos de error que son difíciles de reproducir en producción
  • Hacer demos a clientes sin exponer datos reales
  • Correr pruebas automatizadas sin depender de servicios externos

Mockoon: el servidor de mock APIs más simple

Mockoon es la herramienta que recomiendo para crear mock APIs. Es de código abierto, tiene interfaz gráfica, y en minutos tienes un servidor corriendo.

Para instalarla, ve a mockoon.com y descarga la versión para tu sistema operativo. Una vez instalada, abre la aplicación.

Creando tu primera ruta

Cuando abres Mockoon por primera vez, verás dos paneles: el izquierdo para gestionar entornos (servidores) y el derecho para las rutas.

Paso 1: Haz clic en “New environment” y dale un nombre. Mockoon crea automáticamente un servidor en el puerto 3000.

Paso 2: En la sección de rutas, verás una ruta GET / ya creada. Haz clic en ella para editarla.

Paso 3: Cambia la ruta de / a /users.

Paso 4: En la sección Body, pega el JSON que quieres que regrese tu API:

[
  {
    "id": 1,
    "nombre": "Abraham",
    "ciudad": "Cancún",
    "rol": "Frontend Developer"
  },
  {
    "id": 2,
    "nombre": "Brenda",
    "ciudad": "Mérida",
    "rol": "Backend Developer"
  }
]

Paso 5: Haz clic en el botón de Play (triángulo) para arrancar el servidor.

Ahora puedes abrir tu navegador o Postman y hacer una petición a http://localhost:3000/users. Verás tus datos JSON de respuesta.

Mockoon también soporta datos dinámicos usando su sistema de templates. Por ejemplo, para generar una lista de 10 usuarios aleatorios:

[
  {{#repeat 10}}
  {
    "id": {{@index}},
    "nombre": "{{faker 'name.firstName'}} {{faker 'name.lastName'}}",
    "email": "{{faker 'internet.email'}}"
  }
  {{/repeat}}
]

Exponer tu mock API al internet con ngrok

Tener la API en localhost está bien para desarrollo local, pero ¿qué pasa si necesitas compartirla con un cliente, un compañero remoto, o probar un webhook? Ahí entra ngrok.

ngrok crea un túnel desde tu máquina local hacia un dominio público en internet.

Instalación:

Mac:

brew install ngrok/ngrok/ngrok

Windows/Linux: descarga el binario desde ngrok.com/download.

Configuración (solo la primera vez):

  1. Crea una cuenta gratuita en ngrok.com
  2. Copia tu authtoken desde el dashboard
  3. Ejecuta: ngrok config add-authtoken TU_TOKEN

Exposición de tu servidor:

Con tu servidor Mockoon corriendo en el puerto 3000:

ngrok http 3000

ngrok te dará una URL pública como https://abc123.ngrok.io. Esa URL apunta directamente a tu servidor local. Compártela con quien quieras y tendrán acceso a tu mock API.

Casos de uso reales

Frontend sin backend: Tu equipo acordó el contrato de la API (qué endpoints existen y qué datos devuelven). El equipo de frontend crea la mock API con esas especificaciones y avanza el desarrollo mientras el backend la implementa.

Pruebas de error: Configura Mockoon para que ciertos endpoints devuelvan errores 500, 404 o 401. Así puedes probar cómo maneja tu aplicación los casos de error sin tener que forzarlos en el servidor real.

Demos y presentaciones: En lugar de conectar al servidor de producción en una demo, usas datos controlados y predecibles que siempre funcionan.

Pruebas de webhooks: Si desarrollas integraciones con servicios externos que envían webhooks, puedes usar ngrok para recibir esos webhooks en tu máquina local sin necesitar un servidor en producción.

Las mock APIs son una herramienta que, una vez que la incorporas a tu flujo de trabajo, no puedes imaginar cómo trabajabas sin ella. Mockoon y ngrok son una combinación imbatible para esto y ambas son completamente gratuitas en sus planes básicos.