OpenAPI.Tools - an Open Source list of great tools for OpenAPI.
Description: Documentation for the Oxlip API language.
Menu Expand (external link) Document Search Copy Copied Oxlip API Language Home Capabilities Installation Usage Hello world Overview of the language Design decisions Related work Examples Playground Oxlip on GitHub This site uses Just the Docs , a documentation theme for Jekyll. Oxlip playground Oxlip on GitHub This is the documentation for the Oxlip API Language .
Oxlip is a high-level functional programming language for designing OpenAPI definitions. As an Interface Description Language , it is not general purpose. The motivation is to alleviate the pain of managing OpenAPI in JSON or YAML by hand and at scale. Oxlip defines algebraic abstractions over REST concepts, not too dissimilar to Sass/SCSS over CSS .
There are pros and cons to both API-design-first and OpenAPI generated from implementation. As OpenAPI is better produced or consumed by machines rather than humans, Oxlip tries to help API-design-first teams with better tooling.
OpenAPI.Tools - an Open Source list of great tools for OpenAPI.