The Vizroute blog

• How to compare two OpenAPI versions without missing a breaking change — Why a text diff and even a JSON diff miss the changes that break API clients, what an API-aware comparison checks instead, and a short review checklist.
• WSDL to OpenAPI — how each SOAP operation becomes a REST endpoint — The rules Vizroute uses to turn a WSDL into an OpenAPI design — verbs, paths, identifiers, status codes and faults — and the cases it flags for a person to decide.
• How Vizroute turns an OpenAPI file into a map — What the parser actually does with your specification — the tags it groups by, the servers it resolves, the $refs it follows, and the parts it will not guess at.