Convert Swagger JSON to RAML/YAML

json api yaml swagger raml
helios picture helios · Sep 23, 2015 · Viewed 36.5k times · Source

How do I convert Swagger JSON to RAML/YAML and validate it? I am not looking for a programmatic way, just a one off conversion.

Answer

helios picture helios · Sep 23, 2015

Here are the steps:

  1. Export Swagger JSON into a file on your drive. This JSON should be published on your server at the following URI: /swagger/docs/v1
  2. Go to http://editor.swagger.io/#/
  3. On the top left corner, select File-> Import File... Point to the local Swagger JSON file you exported in step #1 to open in the Swagger Editor
  4. Select Generate Client -> Swagger YAML option from the menu
  5. It will generate the YAML that you can validate at http://www.yamllint.com/ site

Related questions

JSONDecodeError: Expecting value: line 1 column 1 (char 0)

I am getting error Expecting value: line 1 column 1 (char 0) when trying to decode JSON. The URL I use for the API call works fine in the browser, but gives this error when done through a curl request. The following is …

Read More
How to use cURL to get jSON data and decode the data?

So I have a link that returns a jSON object, and I need to have it decoded and put into variables in PHP. URL api.php?action=getThreads&hash=123fajwersa&node_id=4&order_by=post_date&…

Read More
Get a json via Http Request in NodeJS

Here is my model with a json response: exports.getUser = function(req, res, callback) { User.find(req.body, function (err, data) { if (err) { res.json(err.errors); } else { res.json(data); } }); }; Here I get it via http.request. Why do …

Read More