Add organization and location to foreman.

This feature allows foreman to provide multi location, multi tenant and
multi organizations capablities.

the idea is that resources within foreman (e.g. hosts, subnets, users,
environments etc) can belong to one or more locations and organization,...

This commit adds most of the functionality required for API v1

The overall goal was to extract the existing JSON response
overall controllers, and to move them to a seperate name space.

• documentation was added to all requests (available under /apidoc)...

fixes #1872 - Adds Puppet v3 support

minor API v1 fixes

• fix unknown variable name
• enable apipie params validation
• update config_template api doc

update api documentation

• remove #set_resource_params from Api::BaseController to leave :id param under :id for apipie validations to work
• fix custom apipie validators to return nice errors
• enable apipie validations for bugs to be caught early
• log apipie param errors with info level...

[API] - minor fixes

- fixed api index action still refering to old restsapi gem
- currently forced apipie to load DSL so we can reuse its DSL in our views

api v1 - restapi renamed to apipie

cleanup after merge conflict with latest develop branch

fixes #1764 changing per_page setting would update only after a restart

this commit changes it back to an area in the code which gets evaluated
everytime instead of upon startup only

cleanups to rails 3 boot process