Create Gora OpenAPI specification

As to the discussion lewismc initiated in the
mail list thread we need to implement a REST API for GORA.
This is the initial proposal documentation for the GORA REST API.
The plan will be to implement the API with Apache CXF using CXF's JAXRS implementation.