Как объединить несколько файлов спецификации OpenAPI 3 вместе?

Question

Я хочу объединить спецификацию API, написанную с использованием спецификации OpenAPI 3, которая в настоящее время разделена на несколько файлов, которые ссылаются друг на друга с использованием $ref.Как я могу это сделать?

Answer 1

Swagger Codegen может разрешить внешние $ refs и создать один файл:

java -jar swagger-codegen-cli-3.0.4.jar generate -i ./path/to/openapi.yaml -l openapi -o ./RESOLVED

Answer 2

Один из способов сделать это - использовать проект с открытым исходным кодом speccy .

Открыть терминал и установить speccy, запустив (требуется Node.js ):

npm install speccy -g

Затем выполните:

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