o2r Web API
Project description: https://o2r.info
We're a research project, so everything in this API and its documentation is subject to change.
The "working" state should always be in the
master branch, which is published online at https://o2r.info/api, and open pull requests reflect features under development.
This specification is written in Markdown and deployed automatically using Travis CI.
You can use
mkdocs to render it locally, or view the latest master-branch on https://o2r.info/api/.
See the MkDocs documentation for details.
# pip install mkdocs # mkdocs --version mkdocs serve mkdocs build
The current master branch is automatically built on Travis CI and deployed to the GitHub Page at https://o2r.info/api/. Our combination of the
.deploy.sh will run the
mkdocs command on every direct commit or merge on the master branch and deploy the rendered HTML documents to the
gh-pages branch in this repository.
Travis authenticates its push to the
gh-pages branch using a personal access token of the user @o2r-user. The access token is encrypted in the
.travis.yml using Travis CLI for the repository o2r-project/api:
travis encrypt GH_TOKEN=<token here>
GH_TOKEN is used in the deploy script. The token generated on the GitHub website should not be stored anywhere, simply generate a new one if needed.
This has some security risks, as described here. To mitigate these risks, we have disabled the option "Build pull requests" is on the Travis configuration page for this repo, so that malicious changes to the Travis configuration file will be noticed by the repository maintainer before merging a pull request.
The o2r Web API specification is licensed under Creative Commons CC0 1.0 Universal License, see file
To the extent possible under law, the people who associated CC0 with this work have waived all copyright and related or neighboring rights to this work.
This work is published from: Germany.