Editor OpenAPI del workspace
YAML/JSON, validación, vista previa y lock en equipos.
Ubicación
En cada workspace, abre Editor OpenAPI desde el menú de APIs o la ruta /workspaces/{id}/openapi-editor. Un mismo workspace tiene un spec OpenAPI enlazado como recurso principal.
Edición
- Contenido en YAML o JSON con resaltado en el editor.
- Validación en tiempo casi real: errores de sintaxis (varios a la vez) y reglas OpenAPI vía el validador integrado.
- Vista previa tipo Swagger UI en el panel derecho cuando el documento es válido.
Guardar
- Con errores de severidad "error" en el validador, el guardado puede estar bloqueado hasta corregirlos.
- En workspaces con varios colaboradores, debes refrescar y tomar el lock antes de editar o guardar; en personal o sin colaboradores no se exige lock.
- Los conflictos de versión (otro usuario guardó antes) se resuelven con recarga o flujo de fusión según muestre el modal.
Redis (entornos locales)
El lock y la presencia usan Redis. Si en desarrollo ves error de servicio no disponible, arranca Redis (por ejemplo docker compose up redis en el backend).
Import desde colección
Puedes cargar OpenAPI generado desde una colección o pegar un spec importado según las opciones de la propia pantalla.