Skip to content

teamdigitale/api-openapi-samples

Repository files navigation

openapi-samples

API samples following given specs.

Converting swagger to openapi-v3

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

Converting openapi-v3 to openapi-v2

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}" ' \;

Processing yaml.src

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

Generating JSONSchema from existing json

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

API Tools

About

OpenAPI Samples for the API Ecosystem project.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published