Address review comments

endpoints/api/__init__.py

@@ -316,8 +316,7 @@ def request_error(exception=None, **kwargs):
   message = 'Request error.'
   if exception:
     message = exception.message
-  if 'message' in data.keys():
-    message = data.pop('message')
+  message = data.pop('message', message)
   raise InvalidRequest(message, data)
 
 

endpoints/api/discovery.py

@@ -183,16 +183,20 @@ def swagger_route_data(include_internal=False, compact=False):
             'type': 'object',
             'properties': {
               'status': {
-                'type': 'integer'
+                'type': 'integer',
+                'description': 'Status code of the response.'
               },
               'type': {
-                'type': 'string'
+                'type': 'string',
+                'description': 'Reference to the type of the error.'
               },
               'detail': {
-                'type': 'string'
+                'type': 'string',
+                'description': 'Details about the specific instance of the error.'
               },
               'title': {
-                'type': 'string'
+                'type': 'string',
+                'description': 'Unique error code to identify the type of error.'
               }
             },
             'required': [

endpoints/api/error.py

@@ -51,6 +51,5 @@ class Error(ApiResource):
     """ Get a detailed description of the error """
     if error_type in ERROR_DESCRIPTION.keys():
         return error_view(error_type), 200
-    else:
-        raise NotFound()
+    raise NotFound()