Jal 900 - Fix swagger issues on consumerAPI

- The swagger operations are all under 'misc : everything else', we need to group by resource.
- Added support for 'Required' and 'Description' attributes (required on properties, description sets the operation 'summary' in the swagger json)
- Added support for optional and required header declaration per operation