API samples following given specs.

Just use this online API

    https://mermade.org.uk/api/v1/convert?url=$YOUR_URL

eg.

    https://mermade.org.uk/api/v1/convert?url=https://sgiauth.azurewebsites.net/explorer/swagger.json

To convert between formats use:

    ./bin/api-spec-converter.sh $INFILE -f openapi_3 -t swagger_2 -s yaml  > $OUTFILE

To convert all v3 files to v2, use:

    find openapi-v3/ -name \*.yaml \
      -exec bash -c 'I="{}"; ./bin/api-spec-converter.sh "$I" -f openapi_3 -t swagger_2 -s yaml > "${I//v3/v2}" ' \;

Some specs may be defined using yaml references (eg. to avoid repeating common headers and responses). While that's valid yaml, explicit is better than implicit. Those files should be exploded with:

    make yaml

See https://github.com/perenecabuto/json_schema_generator

• SwaggerHub OpenAPI v3, v2 editor https://editor.swagger.io
• OpenAPI v3, v2 editor by Red Hat https://github.com/apicurio/apicurio-studio
• openapi-resolver, a python package for creating openapi bundles (resolving $refs and adding them as components) and normalize OAS3 files. https://github.com/ioggstream/openapi-resolver