removed params required => from update action

smart proxies api - filtering by proxy type

subnets api - removed required constraints from fields in update

The required constraints were blocking partial updates.

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)...

adds foreman versions to response headers

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...

• fix user documentation
• remove password_confirmation from user api
• Add json template for users#create

Subnets API

added environment API