Tema 16 · Mock Servers

Mock Servers: Simulación de Endpoints antes de Programar el Backend

Aprende a crear Mock Servers en Postman para simular respuestas de backend y permitir que los equipos de Frontend y Móvil avancen sin esperar a que el servidor esté programado.

Documentación Interactiva de APIs con Markdown y Ejemplos Newman CLI: Ejecución de Pruebas de APIs en Terminal y CI/CD

El Enfoque "API First" y los Cuellos de Botella

En el desarrollo de software tradicional, los programadores de Frontend (React, Vue, Flutter, iOS) frecuentemente se quedan bloqueados esperando a que el equipo de Backend termine de programar las rutas, modelos y migraciones en la base de datos.

Un Mock Server (Servidor Simulado) resuelve este problema: simula el comportamiento de una API real devolviendo datos de prueba realistas a partir de los Ejemplos previamente guardados en una colección de Postman.

¿Cómo Funciona el Mock Server de Postman?

  1. Crear el Mock Server: Selecciona tu Colección ➔ Menú de tres puntos ➔ Mock collection. Postman te proporcionará una URL pública y segura (ejemplo: https://a4b1-c2d3.mock.pstmn.io).
  2. Vincular la Variable de Entorno: Asigna esa URL a tu variable {{base_url}}.
  3. Coincidencia de Rutas (Matching Algorithm): Cuando envías GET {{base_url}}/usuarios, Postman inspecciona los ejemplos guardados en esa petición y devuelve de inmediato el JSON correspondiente.

Control Avanzado con Cabeceras `x-mock-*`

Puedes forzar al Mock Server a comportarse de formas específicas inyectando cabeceras personalizadas en la petición:

Cabecera HTTP Función y Ejemplo de Valor
x-mock-response-code Fuerza a responder con un código HTTP específico (ej: 404, 500 o 422) para probar cómo tu app maneja errores.
x-mock-response-name Selecciona un ejemplo concreto por su nombre textual (ej: "Usuario Suspendido").

⚡ Petición a un Mock Server con Simulación de Error 404

Configuración de cabeceras para forzar al Mock Server a devolver un error sin tocar el servidor real:

mock-request-headers.http
Solo lectura 
# Petición enviada al servidor simulado en Postman:
GET https://a4b1-c2d3.mock.pstmn.io/api/v1/cursos/999 HTTP/1.1
Host: a4b1-c2d3.mock.pstmn.io
Content-Type: application/json

# Cabecera para forzar al Mock Server a devolver el ejemplo con error 404:
x-mock-response-code: 404

# ========================================================
# RESPUESTA INMEDIATA RECIBIDA DEL MOCK SERVER:
# HTTP/1.1 404 Not Found
# Content-Type: application/json; charset=utf-8
# ========================================================
# {
#   "error": true,
#   "codigo": "CURSO_NO_ENCONTRADO",
#   "mensaje": "El recurso solicitado con ID 999 no existe en el catálogo."
# }
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué cabecera HTTP especial permite forzar a un Mock Server de Postman a devolver un código de error específico (como 404 o 500)?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual de Postman: Pruebas de APIs REST & Automatización y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

Conocer el Bootcamp

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.