search

openmobilityfoundation / mds-openapi

OpenAPI description for MDS data feeds, managed by the Open Mobility Foundation.
https://openmobilityfnd.stoplight.io/docs/mds-openapi
Other
10 stars 3 forks source link

Is it possible to create somehow one OpenApi file? #38

Open edwinvandenbelt opened 1 year ago

edwinvandenbelt commented 1 year ago

I'm used to generate code using the swagger editor (https://editor.swagger.io/). Therefore the code should be in one file. Is it possible to obtain all the parts in one file?

thekaveman commented 1 year ago

Hello @edwinvandenbelt - yes, this is possible from the Stoplight web interface: https://openmobilityfnd.stoplight.io/docs/mds-openapi

Select an API by clicking on the cloud icon for that API (e.g. the Agency API):

image

Then look at the far right for the Export dropdown, and select Bundled References:

image

This will package everything for that API into a single YAML file and download it.

edwinvandenbelt commented 1 year ago

Ah. Ok, works partly. I need to implement as well a few endpoints from policy, geography and provider... I do have 3 different yamls to integrate. And you are using OpenAPI 3.1.0. You're running ahead of the troops. Most generators can cope with 3.0.0, but that's not your main concern.