OpenAPI: Added required description to responses. (#6850)

Author: chrisv2

rest_framework/schemas/openapi.py

@@ -490,6 +490,10 @@ def _get_responses(self, path, method):
                 'content': {
                     ct: {'schema': response_schema}
                     for ct in self.content_types
-                }
+                },
+                # description is a mandatory property,
+                # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#responseObject
+                # TODO: put something meaningful into it
+                'description': ""
             }
         }

tests/schemas/test_openapi.py

@@ -84,6 +84,7 @@ def test_path_without_parameters(self):
             'parameters': [],
             'responses': {
                 '200': {
+                    'description': '',
                     'content': {
                         'application/json': {
                             'schema': {
@@ -190,6 +191,7 @@ class View(generics.GenericAPIView):
         responses = inspector._get_responses(path, method)
         assert responses['200']['content']['application/json']['schema']['required'] == ['text']
         assert list(responses['200']['content']['application/json']['schema']['properties'].keys()) == ['text']
+        assert 'description' in responses['200']
 
     def test_response_body_nested_serializer(self):
         path = '/'
@@ -243,6 +245,7 @@ class View(generics.GenericAPIView):
         responses = inspector._get_responses(path, method)
         assert responses == {
             '200': {
+                'description': '',
                 'content': {
                     'application/json': {
                         'schema': {
@@ -283,6 +286,7 @@ class View(generics.GenericAPIView):
         responses = inspector._get_responses(path, method)
         assert responses == {
             '200': {
+                'description': '',
                 'content': {
                     'application/json': {
                         'schema': {