AAP-47292 feature flags response description (ansible#743)

Fix openapi docs for feature flags - describe the response type

Author: bhavenst

ansible_base/feature_flags/views.py

@@ -1,3 +1,4 @@
+from django.conf import settings
 from django.utils.translation import gettext_lazy as _
 from rest_framework.response import Response
 
@@ -17,9 +18,23 @@ class FeatureFlagsStateListView(AnsibleBaseView):
     name = _('Feature Flags')
     http_method_names = ['get', 'head']
 
-    def get(self, request, format=None):
+    def _get(self, request, format=None):
         self.serializer = FeatureFlagSerializer()
         return Response(self.serializer.to_representation())
 
     def get_queryset(self):
         return get_django_flags()
+
+    # Conditionally add openapi documentation for feature flags
+    if 'ansible_base.api_documentation' in settings.INSTALLED_APPS:
+        from drf_spectacular.types import OpenApiTypes
+        from drf_spectacular.utils import OpenApiExample, extend_schema
+
+        @extend_schema(request=None, responses=OpenApiTypes.OBJECT, examples=[OpenApiExample(name="featureflags", value={"FLAG1": True, "FLAG2": False})])
+        def get(self, request, format=None):
+            return self._get(request, format)
+
+    else:
+
+        def get(self, request, format=None):
+            return self._get(request, format)