Parameters api fixes

- fixed apipie docs
- rabl definition changed to match conventions