Un mock server generado desde tu especificación OpenAPI
Apunta Mockzilla a un documento OpenAPI y todas sus rutas responden de inmediato. Los datos salen de tus propios esquemas, así que respetan tipos, formatos, enums y campos obligatorios en vez de ser el mismo objeto de relleno en todas partes.
- Sin handlers que escribir
- Validación de solicitudes
- Varias APIs, una sola URL
- Motor con licencia MIT
{
"id": "cus_9Fh2",
"email": "dana@example.com",
"currency": "eur",
"balance": 4210,
"created": 1772841600,
"delinquent": false
}¿Qué es un mock server de OpenAPI?
Un servidor que lee un documento OpenAPI y responde todas sus rutas con datos que coinciden con los esquemas que declaraste. Sin handlers, sin fixtures y sin una segunda descripción de la API que mantener al día con la primera.
Mockzilla toma la spec como su única entrada. Súbela, o agrega la GitHub Action al repositorio donde vive, y cada endpoint empieza a responder en una URL estable que todo tu equipo puede llamar.
Esperando una API que ya sabes describir
La spec suele acordarse mucho antes de que la API exista. Hasta entonces el frontend está bloqueado, las pruebas de integración no tienen contra qué correr, y todo el mundo escribe fixtures desechables que en una semana ya no coinciden con el contrato.
El mock se construye desde la spec misma, así que no puede desviarse. Cambia la spec y el mock cambia con ella. Si un endpoint necesita una respuesta exacta, escribe solo esa a mano y el resto sigue generándose.
Generado desde tus esquemas
Cada endpoint devuelve datos que validan contra su propio esquema de respuesta: tipos, formatos, enums, campos obligatorios y objetos anidados.
Validación de solicitudes
Las solicitudes entrantes se verifican contra la spec, así que un body incorrecto o un parámetro faltante falla en el mock en vez de pasar en silencio.
Varias APIs en un servidor
Cada spec se vuelve un servicio con su propio prefijo de URL, así que tu API y las de terceros de las que dependes responden en el mismo host.
Preguntas
- ¿Tengo que escribir yo las respuestas?
- No. La spec es la entrada, y todas sus rutas responden sin que escribas nada.
- ¿Puedo sobrescribir un endpoint con una respuesta fija?
- Sí. Pon un archivo JSON en esa ruta y responderá exactamente con ese body, mientras el resto de la spec sigue generando. Lo mismo funciona para rutas que tu spec ni siquiera describe.
- ¿Y si un endpoint necesita lógica real?
- Para eso está el modo codegen. Mockzilla genera handlers de Go tipados desde tu spec, tú escribes el comportamiento que necesitas y subes el servidor compilado. Todo lo que no tocaste sigue respondiendo desde la spec.
- ¿Qué tan confiables son los datos generados?
- La generación de respuestas se prueba de forma continua contra 2.215 documentos OpenAPI públicos que cubren 98.464 endpoints, y cada endpoint tiene que producir datos que validen contra su propio esquema.
Trae una spec. Llévate un mock server.
Empezar no cuesta nada. Infraestructura dedicada cuando la necesites.