Better API documentation.

modoboa/parameters/api/v2/serializers.py

@@ -34,3 +34,10 @@ class StructureSerializer(serializers.Serializer):
     name = serializers.CharField()
     display = serializers.CharField(help_text="Display rule")
     parameters = ParameterSerializer(many=True)
+
+
+class AppParametersSerializer(serializers.Serializer):
+    """Serializer for application parameters."""
+
+    label = serializers.CharField()
+    params = serializers.DictField()

modoboa/parameters/api/v2/viewsets.py

@@ -36,15 +36,19 @@ class ParametersViewSet(viewsets.ViewSet):
                 description='A registered application name',
                 type=str, required=True
             ),
-        ]
+        ],
+        responses=serializers.AppParametersSerializer
     )
     def retrieve(self, request, pk: str):
         """Return all parameters for given app."""
         parameters = request.localconfig.parameters.get_values_dict(pk)
         serializer = tools.registry.get_serializer_class("global", pk)(
             parameters)
-        data = {"params":serializer.data, "label":tools.registry.get_label("global", pk)}
-        return response.Response(data)
+        result = serializers.AppParametersSerializer({
+            "label": tools.registry.get_label("global", pk),
+            "params": serializer.data
+        })
+        return response.Response(result.data)
 
     @extend_schema(
         parameters=[