Showing results for 
Search instead for 
Did you mean: 

Best way to combine multiple OpenAPI specifications

New Member

Best way to combine multiple OpenAPI specifications

ExLibris' products Alma and Primo have comprehensive REST APIs, and similar to many vendors they divide these into multiple API Specifications.   This is a problem for me because:


(a) I will need to run swagger-codegen multiple times

(b) I will need to handcraft the deserialization process.  Even there I run into problems because there could be multiple inline body classes.

(c) Or, I will need to combine the different APIs I need by hand into one OpenAPI specification.


Online, I found a blog post that suggested using the npm package speccy to combine them -


But I get some messages about deprecated packages.  Is there any capability in OpenAPI itself to combine specifications beyond referencing schemas?     Is there a more maintained tool that does the combining I am looking for?


New Here?
Join us and watch the welcome video: