swaggeropenapi

How do I combine multiple OpenAPI 3 specification files together?

I want to combine an API specification written using the OpenAPI 3 spec, that is currently divided into multiple files that reference each other using $ref. How can I do that?

Solution

  • One way to do this is to use the open-source project speccy.

    Open the terminal and install speccy by running (requires Node.js):

    npm install speccy -g

    Then run:

    speccy resolve path/to/spec.yaml -o spec-output.yaml