karussell
commented
5 years ago Ok, we'll go with our API spec as a single point of truth and let users create their API clients via the swagger editor. More details are described here: https://github.com/graphhopper/directions-api-clients#deprecated-notice
We have made good progress and are now using OpenAPI spec v3 for the GraphHopper Directions API!
We then created our docs from it via https://github.com/Rebilly/ReDoc (actually a fork as we had a few problems and PRs seems to be ignored)
Unfortunately it seems that our latest spec
https://docs.graphhopper.com/openapi.yaml (sources in doc repo)
fails for openapi-generator:
https://github.com/graphhopper/directions-api-doc/issues/14
Using swagger codegen it worked after some problems: #38