These are chat archives for APIs-guru/api-models

3rd
May 2018
Stefan Junker
@steveeJ
May 03 2018 09:11
hey, are there any projects that provide tooling or libraries for transforming arbitrary API descriptions which are written in JSON to OpenAPI?
Mike Ralphson
@MikeRalphson
May 03 2018 09:22
I don't know of anything specific, but you could use something like https://github.com/ColinEberhardt/json-transforms to massage the input JSON, then, if needed, one of the OAS libraries (see openapi.tools) to create the final OpenAPI definition. If you find something, it would be useful to share it, so it can be used for APIs-guru/openapi-directory#188
Stefan Junker
@steveeJ
May 03 2018 09:29
thanks for the links Mike. so I get your suggestion is to write it in JS?
cloudcheckr.com provides an endpoint that exposes the known endpoints in JSON format. the linked file is a cache of it in YAML form
unfortunately it lacks result information
Mike Ralphson
@MikeRalphson
May 03 2018 10:09
Other languages are (I believe) available. :smile: There are some good JSON transform tools available in Java I think. If you can find a nice DSL to OpenAPI tool you like, it looks like piping the YAML through that would be quite easy. There's only really the parameter information there, and you're going to have to default quite a lot of the OpenAPI boilerplate.
Mike Ralphson
@MikeRalphson
May 03 2018 10:16
You might have more luck using the HTML API reference here http://support.cloudcheckr.com/cloudcheckr-api-userguide/cloudcheckr-api-reference-guide/ and using https://github.com/bobby-brennan/scrape-to-swagger if you're happy with regexes and CSS selectors.
Stefan Junker
@steveeJ
May 03 2018 13:08
@MikeRalphson It's unclear, as I don't know the documentation process at cloudcheckr. the endpoints endpoint might be more accurate in regards to currency