# OpenAPI
| | The **OpenAPI Specification**, previously known as the Swagger Specification, is a specification for a machine-readable interface definition language for describing, producing, consuming and visualizing web services. Previously part of the Swagger framework, it became a separate project in 2015, overseen by the OpenAPI Initiative, an open-source collaboration project of the Linux Foundation. |
|-|-|
| | wikipedia:: [OpenAPI Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification) |
aka:: "OAS"
Previously known as Swagger Specification, but swagger is still around as an implementation of openApi
[Home - OpenAPI Initiative](https://www.openapis.org/)
[API Documentation & Design Tools for Teams | Swagger](https://swagger.io/)
Applications implemented based on OpenAPI interface files can automatically generate documentation of methods, parameters and models.
[[API]]
## RESTful
## RAML
[RAML (software) - Wikipedia](https://en.wikipedia.org/wiki/RAML_(software))
## Tools
[OpenAPI Tooling](https://tools.openapis.org/)
### VS Code Plugin
## Best Practices
- [Best Practices | OpenAPI Documentation](https://learn.openapis.org/best-practices)
## [[Swagger UI]]
## Sources
https://onlineornot.com/built-my-http-docs-from-scratch