Skip to content

Commit

Permalink
Updated documentation about client code generation
Browse files Browse the repository at this point in the history
  • Loading branch information
giordy committed Dec 1, 2021
1 parent 23de253 commit 76c4050
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,11 @@ npm run serve -- --watch
Now open http://localhost:8080/. You should see the generated API doc.

Make modifications to `doc/specs/lichess-api.yaml`, and reload the page to see your changes.

## Auto-generate client code

You may use the spec file to quickly auto-generate the client code needed to interface your software to the Lichess API.

To do so, you shall use the [OpenAPI Generator](https://openapi-generator.tech).

Unfortunately, the generator does not yet support the 3.1 version of the OpenAPI specification used by Lichess ([see this issue](https://github.com/OpenAPITools/openapi-generator/issues/9083)), hence for now you should use the `doc/specs/lichess-api-3.0.yaml` file with it. The 3.1 format slightly differs with the 3.0 format, however the generated code is equivalent.

0 comments on commit 76c4050

Please sign in to comment.