chore(rest-api): document GET jackson-mapped Serializable variables

- marked as deprecated because the feature is only useful when the REST API
  has access to the involved classes; nevertheless, we cannot remove this
  existing API feature

related to CAM-2435