This project was migrated into "rudder" main repository on 2020-03-04. The source has been rewritten in openapi specification format.
Please go to: https://github.com/Normation/rudder/tree/master/api-doc
Building the doc requires installing:
npm install -g redoc-cli @redocly/openapi-cli-
openapi-clibuild a single openapi file from the sources -
redoc-cliproduces the HTML output from the openapi file
Then run:
make openapiAnd The resulting files will be in build/.
If you are interested about using Rudder REST API, you should simply look at the generated documentation.
The project is the one that manage the REST API web site creation. It is based on APIDoc (http://apidocjs.com).
The build needs NodeJS and npm, see: http://apidocjs.com/#install
To build the whole things, once nodejs is installed, just execute the build.sh script
Current version is 0.17.5.
To update the template from a new version of apidoc you need to get all of the new ${APIDOC_DIRECTORY}/template directory content except : - index.html that has been modified localy
index.html just has a slight modification located between 2 comments "XXX Local modifications XXX"