Enhance API structure and documentation: Added new tags for Account, Integration, Automation, Linker, Optimizer, and Publisher; updated billing endpoints for admin and customer; improved API reference documentation; fixed endpoint paths in frontend services.

backend/igny8_core/modules/billing/admin_urls.py

@@ -1,6 +1,10 @@
 from django.urls import path
 from rest_framework.routers import DefaultRouter
+
 from .views import AdminBillingViewSet
+from igny8_core.business.billing.views import (
+    AdminBillingViewSet as BillingAdminViewSet,
+)
 
 router = DefaultRouter()
 
@@ -9,6 +13,12 @@ urlpatterns = [
     path('users/', AdminBillingViewSet.as_view({'get': 'list_users'}), name='admin-users-list'),
     path('users/<int:user_id>/adjust-credits/', AdminBillingViewSet.as_view({'post': 'adjust_credits'}), name='admin-adjust-credits'),
     path('credit-costs/', AdminBillingViewSet.as_view({'get': 'list_credit_costs', 'post': 'update_credit_costs'}), name='admin-credit-costs'),
+    # Unified admin billing endpoints (alias legacy /billing/admin/* under /admin/billing/*)
+    path('billing/invoices/', BillingAdminViewSet.as_view({'get': 'invoices'}), name='admin-billing-invoices'),
+    path('billing/payments/', BillingAdminViewSet.as_view({'get': 'payments'}), name='admin-billing-payments'),
+    path('billing/pending_payments/', BillingAdminViewSet.as_view({'get': 'pending_payments'}), name='admin-billing-pending-payments'),
+    path('billing/<int:pk>/approve_payment/', BillingAdminViewSet.as_view({'post': 'approve_payment'}), name='admin-billing-approve-payment'),
+    path('billing/<int:pk>/reject_payment/', BillingAdminViewSet.as_view({'post': 'reject_payment'}), name='admin-billing-reject-payment'),
 ]
 
 urlpatterns += router.urls

backend/igny8_core/modules/billing/urls.py

@@ -20,6 +20,9 @@ urlpatterns = [
     path('', include(router.urls)),
     # User-facing billing overview
     path('account_balance/', BillingOverviewViewSet.as_view({'get': 'account_balance'}), name='account-balance'),
+    # Canonical credit balance endpoint
+    path('credits/balance/', CreditBalanceViewSet.as_view({'get': 'list'}), name='credit-balance-canonical'),
+    # Explicit list endpoints
     path('transactions/', CreditTransactionViewSet.as_view({'get': 'list'}), name='transactions'),
     path('usage/', CreditUsageViewSet.as_view({'get': 'list'}), name='usage'),
     # Admin billing endpoints

backend/igny8_core/modules/billing/views.py

@@ -26,7 +26,7 @@ from .exceptions import InsufficientCreditsError
 
 
 @extend_schema_view(
-    list=extend_schema(tags=['Billing']),
+    list=extend_schema(tags=['Billing'], summary='Get credit balance'),
 )
 class CreditBalanceViewSet(viewsets.ViewSet):
     """
@@ -38,8 +38,7 @@ class CreditBalanceViewSet(viewsets.ViewSet):
     throttle_scope = 'billing'
     throttle_classes = [DebugScopedRateThrottle]
     
-    @action(detail=False, methods=['get'])
-    def balance(self, request):
+    def list(self, request):
         """Get current credit balance and usage"""
         account = getattr(request, 'account', None)
         if not account:
@@ -125,6 +124,7 @@ class CreditUsageViewSet(AccountModelViewSet):
         
         return queryset.order_by('-created_at')
     
+    @extend_schema(tags=['Billing'], summary='Get usage summary')
     @action(detail=False, methods=['get'])
     def summary(self, request):
         """Get usage summary for date range"""
@@ -214,6 +214,7 @@ class CreditUsageViewSet(AccountModelViewSet):
         serializer = UsageSummarySerializer(data)
         return success_response(data=serializer.data, request=request)
     
+    @extend_schema(tags=['Billing'], summary='Get usage limits')
     @action(detail=False, methods=['get'], url_path='limits', url_name='limits')
     def limits(self, request):
         """
@@ -434,6 +435,13 @@ class BillingOverviewViewSet(viewsets.ViewSet):
         return Response(data)
 
 
+@extend_schema_view(
+    stats=extend_schema(tags=['Admin Billing'], summary='Admin billing stats'),
+    list_users=extend_schema(tags=['Admin Billing'], summary='List users with credit info'),
+    adjust_credits=extend_schema(tags=['Admin Billing'], summary='Adjust user credits'),
+    list_credit_costs=extend_schema(tags=['Admin Billing'], summary='List credit cost configurations'),
+    update_credit_costs=extend_schema(tags=['Admin Billing'], summary='Update credit cost configurations'),
+)
 class AdminBillingViewSet(viewsets.ViewSet):
     """Admin-only billing management API"""
     permission_classes = [IsAuthenticatedAndActive, permissions.IsAdminUser]