diff --git a/radar/2019-11-01/open-api.md b/radar/2019-11-01/open-api.md new file mode 100644 index 0000000..c9a9dc6 --- /dev/null +++ b/radar/2019-11-01/open-api.md @@ -0,0 +1,21 @@ +--- +title: "Open API" +ring: adopt +quadrant: tools + +--- + +RAML and Swagger have been merged to OpenAPI. +The OpenAPI Specification is becoming a broadly adopted industry standard for describing modern APIs. + +OpenAPI v2 version is basically the former Swagger - and Swagger provides useful tools for OpenAPI like the online editor and viewer http://editor.swagger.io/ +We have also found that this version currently have a good tool support accross languages, so you will find API client and server generation tools for a lot of languages, which makes it quite easy to connect to an API that is described in OpenAPI standard. + + +**OpenAPI v3** + +OpenAPI v3 adds more features to the specification - for example the ability to describe APIs supporting request/callback pattern. + +There is a very good api designer https://www.apicur.io/ and a good mock generator http://microcks.github.io/index.html + +The general tool support is excellent. See https://openapi.tools/ \ No newline at end of file diff --git a/radar/2019-11-01/raml.md b/radar/2019-11-01/raml.md index 7d2c12c..192ea92 100644 --- a/radar/2019-11-01/raml.md +++ b/radar/2019-11-01/raml.md @@ -5,4 +5,6 @@ quadrant: languages-and-frameworks --- -Since the RAML ecosystem lacks further development and additional tools, we decided to not stick with it anymore. \ No newline at end of file +Since the RAML ecosystem lacks further development and additional tools, we decided to not stick with it anymore. + +Consider using ["OpenAPI"](/tools/open-api.html) instead. \ No newline at end of file