Simular un endpoint de API REST

Obtén un endpoint JSON público para desbloquear tu frontend antes de que exista el backend.

Un endpoint de API REST simulado es una URL pública que devuelve el JSON que definiste, sin ningún servidor propio detrás. Describes el método, el código de estado y el cuerpo de la respuesta una vez, y el mock responde a cada llamada exactamente con eso. Es la forma más rápida de desbloquear el trabajo del frontend mientras el backend real aún se está escribiendo.

¿Qué JSON debería devolver el mock?

Devuelve la respuesta que tu interfaz realmente espera, no un sustituto simplificado. El valor total del mock es que escribes código de análisis real contra él, por lo que la forma debe coincidir con el contrato que acordaste con el equipo de backend.

  • Mantén la envoltura. Si la API real envuelve los resultados como {"data": [...], "total": 42}, simula la envoltura también.
  • Mantén los tipos. Una identificación que es una cadena en producción debe ser una cadena aquí.
  • Incluye los campos incómodos. Nulos, arreglos vacíos y claves opcionales son exactamente lo que tu código de renderizado hace mal, así que pon al menos uno de cada uno en el fixture.

¿Cómo simulas respuestas de error y CORS?

Un mock que siempre devuelve 200 prueba la mitad de tu código. Establece response_status en 404, 422 o 500 y apunta un segundo mock a él, para que tus ramas de error se ejerciten tan deliberadamente como la ruta feliz.

Si llamas al mock desde un navegador en lugar de desde curl, establece cors_enabled en verdadero. Sin él, el navegador bloquea la respuesta antes de que tu código la vea.

¿Cómo intercambias el mock por la API real más tarde?

Pon la URL base en la configuración el primer día, nunca en línea en un componente. Apúntala a la URL del mock ahora y al host real más tarde, y el cambio será una modificación de una línea en lugar de una búsqueda por todo el código base.

Los mocks aquí duran siete días por defecto y hasta treinta como máximo, lo cual suele ser más tiempo que la brecha que estás cubriendo.

¿Qué suele salir mal?

  • Simular la respuesta que desearías tener. Diseña el fixture a partir del contrato real del backend, no a partir de lo que sería conveniente renderizar.
  • Olvidar el tipo de contenido. Sin "content_type": "application/json" muchos clientes te dan una cadena y tu analizador falla.
  • Probar solo la ruta feliz. Si ninguna prueba ve nunca un 500, tu manejo de errores no está probado.
  • Dejar la URL del mock en una rama fusionada. Configuración, no código fuente.

Cuándo usar esto

Cuando el backend no está listo, el frontend se detiene. Levanta un mock que devuelva el JSON exacto que tu UI espera, obtén una URL pública y construye contra ella ahora; cambia a la API real más tarde.

Crear el mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "GET",
  "response_status": 200,
  "content_type": "application/json",
  "response_body": "{\"users\":[{\"id\":1,\"name\":\"Ada\"}]}"
}'

Llamarlo

curl https://quickmock.dev/m/<slug>

Lo que obtienes

{"users":[{"id":1,"name":"Ada"}]}

Preguntas frecuentes

¿Necesito una cuenta para crear un endpoint de API REST simulado?
No. No hay registro, ni correo electrónico ni clave de API: envías POST a la definición del mock y obtienes una URL en vivo a cambio. Cada mock devuelve un token de administrador de un solo uso que conservas si quieres editarlo o eliminarlo más tarde.
¿Cuánto tiempo permanece activo el endpoint?
Siete días por defecto, treinta como máximo. Eso cubre la brecha habitual entre "el frontend está listo" y "el backend está listo".
¿Puede cambiar la respuesta entre llamadas?
Sí. Usa tokens de faker para obtener un cuerpo nuevo en cada llamada, una secuencia de respuestas para devolver diferentes estados en orden, o un retraso para simular un endpoint lento. Un cuerpo fijo es solo el caso más simple.

Construye el tuyo propio

Crear un mock

Plantillas listas para usar para esto: Simular una respuesta de token de OAuth2, Simular un documento de descubrimiento OpenID Connect, Simular un endpoint JWKS para la verificación JWT

Guías relacionadas

← Todas las guías

Última actualización: 2026-10-17