Implement v3 support with minimal impact on current use

- Outsource the construction of the URL by introducing self.api_path
  which is built at instanciation of a controller.
- Currently assume v2 to be standard behaviour as it was before.
  Thus there won't be any breakage for current scripts with a v2 controller.
- Update documentation with examples for both v3 use and how to migration from v2.