✨ [#35] feat: Add services choices endpoint

Author: SilviaAmAm

backend/src/openbeheer/api/urls.py

@@ -38,6 +38,9 @@
         include("openbeheer.api.authentication.urls", namespace="authentication"),
     ),
     # ZTC endpoints
+    path(
+      "v1/service/",  include("openbeheer.services.urls", namespace="services")
+    ),
     path(
       "v1/service/<slug:slug>/zaaktypen/",  ZaakTypeListView.as_view(), name="zaaktype-list"
     ),

backend/src/openbeheer/catalogi/api/views.py

@@ -20,6 +20,7 @@
 
 
 @extend_schema(
+    tags=["Catalogi"],
     summary=_("Get Open Zaak choices"),
     description=_(
         "Get the available Open Zaak catalogi instances. The value is the slug of the configured service, "
@@ -35,11 +36,17 @@ class ServiceChoicesView(MsgspecAPIView):
     def get(self, request: Request) -> Response:
         services = Service.objects.filter(api_type=APITypes.ztc)
 
-        data = [{"label": service.label, "value": service.slug} for service in services]
+        data = [
+            OBOption(
+                label=service.label,
+                value=service.slug
+            ) for service in services
+        ]
         return Response(data)
 
 
 @extend_schema(
+    tags=["Catalogi"],
     summary=_("Get catalogue choices"),
     description=_(
         "Retrieve the catalogues available in an Open Zaak instance. "

backend/src/openbeheer/conf/base.py

@@ -131,6 +131,7 @@
     "openbeheer.config",
     "openbeheer.health_checks",
     "openbeheer.catalogi",
+    "openbeheer.services",
 ]
 
 MIDDLEWARE = [

backend/src/openbeheer/services/__init__.py

@@ -0,0 +1,42 @@
+from django.utils.translation import gettext_lazy as _
+
+from drf_spectacular.utils import extend_schema
+
+from zgw_consumers.constants import APITypes
+from zgw_consumers.models import Service
+
+from rest_framework.request import Request
+from rest_framework.permissions import IsAuthenticated
+from rest_framework.response import Response
+
+from openbeheer.api.views import MsgspecAPIView
+
+from openbeheer.types._open_beheer import OBOption
+
+
+
+@extend_schema(
+    tags=["Services"],
+    summary=_("Get Open Zaak choices"),
+    description=_(
+        "Get the available Open Zaak catalogi instances. The value is the slug of the configured service, "
+        "while the label is the name of the service."
+    ),
+    # responses={
+    #     "200": list[OBOption[str]] # TODO blueprint of msgspec (Github #50)
+    # }
+)
+class ServiceChoicesView(MsgspecAPIView):
+    permission_classes = [IsAuthenticated]
+
+    def get(self, request: Request) -> Response:
+        services = Service.objects.filter(api_type=APITypes.ztc)
+
+        data = [
+            OBOption(
+                label=service.label,
+                value=service.slug
+            ) for service in services
+        ]
+        return Response(data)
+

backend/src/openbeheer/services/api/__init__.py

@@ -0,0 +1,14 @@
+from django.urls import path
+
+from .api.views import ServiceChoicesView
+
+
+app_name = "services"
+
+urlpatterns = [
+    path(
+        "choices/",
+        ServiceChoicesView.as_view(),
+        name="choices",
+    ),
+]