stuffies

MODERATION_API_EXAMPLES.json

@@ -1,13 +1,13 @@
 {
   "moderation_examples": {
     "delete_report": {
-      "description": "Eliminar un reporte inapropiado",
+      "description": "Eliminar un reporte (requiere token JWT de admin)",
       "endpoint": "POST /moderation/reports/delete",
       "headers": {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        "Authorization": "Bearer YOUR_JWT_TOKEN"
       },
       "request_body": {
-        "moderator_id": 1,
         "report_id": "550e8400-e29b-41d4-a716-446655440000",
         "reason": "Contenido violento",
         "description": "La imagen contiene violencia explícita"
@@ -16,40 +16,110 @@
         "status": 200,
         "body": {
           "status": "success",
-          "message": "Reporte marcado para eliminación",
+          "message": "Reporte eliminado",
           "action_id": "action-uuid-123"
         }
       },
-      "response_error": {
-        "status": 400,
-        "body": {
-          "detail": "Razón debe tener al menos 5 caracteres"
-        }
+      "response_error_401": {
+        "status": 401,
+        "body": {"detail": "Token inválido o expirado"}
+      },
+      "response_error_403": {
+        "status": 403,
+        "body": {"detail": "Permisos insuficientes"}
       }
     },
-    
     "close_account": {
-      "description": "Cerrar una cuenta de usuario por violación de términos",
+      "description": "Cerrar cuenta de usuario (requiere token JWT de admin)",
       "endpoint": "POST /moderation/accounts/close",
       "headers": {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        "Authorization": "Bearer YOUR_JWT_TOKEN"
       },
       "request_body": {
-        "moderator_id": 1,
         "user_id": 42,
-        "reason": "Violación grave de términos de servicio",
-        "description": "Comportamiento acosador y spam sistemático",
+        "reason": "Violación grave de términos",
+        "description": "Comportamiento acosador",
         "is_permanent": true
       },
       "response_success": {
         "status": 200,
         "body": {
           "status": "success",
-          "message": "Cuenta marcada para cierre",
+          "message": "Cuenta cerrada",
           "action_id": "action-uuid-456"
         }
       }
     },
+    "ban_user": {
+      "description": "Banear usuario (requiere token JWT de admin)",
+      "endpoint": "POST /moderation/users/ban",
+      "headers": {
+        "Content-Type": "application/json",
+        "Authorization": "Bearer YOUR_JWT_TOKEN"
+      },
+      "request_body": {
+        "user_id": 42,
+        "reason": "Spam sistemático",
+        "duration_days": 30,
+        "description": "Múltiples reportes de spam"
+      },
+      "response_success": {
+        "status": 200,
+        "body": {
+          "status": "success",
+          "message": "Usuario baneado por 30 días",
+          "action_id": "action-uuid-789"
+        }
+      }
+    },
+    "warn_user": {
+      "description": "Advertir usuario (requiere token JWT de admin)",
+      "endpoint": "POST /moderation/users/warn",
+      "headers": {
+        "Content-Type": "application/json",
+        "Authorization": "Bearer YOUR_JWT_TOKEN"
+      },
+      "request_body": {
+        "user_id": 42,
+        "reason": "Lenguaje inapropiado",
+        "description": "Primera advertencia"
+      },
+      "response_success": {
+        "status": 200,
+        "body": {
+          "status": "success",
+          "message": "Usuario advertido",
+          "action_id": "action-uuid-101"
+        }
+      }
+    },
+    "review_content": {
+      "description": "Revisar contenido reportado (requiere token JWT de admin)",
+      "endpoint": "POST /moderation/content/review",
+      "headers": {
+        "Content-Type": "application/json",
+        "Authorization": "Bearer YOUR_JWT_TOKEN"
+      },
+      "request_body": {
+        "report_id": "550e8400-e29b-41d4-a716-446655440000",
+        "action": "approve",
+        "reason": "Contenido válido según políticas",
+        "notes": "Aprobado después de revisión"
+      },
+      "response_success": {
+        "status": 200,
+        "body": {
+          "status": "success",
+          "message": "Decisión registrada",
+          "action_id": "action-uuid-202"
+        }
+      }
+    }
+  }
+}
+      }
+    },
     
     "ban_user": {
       "description": "Banear un usuario temporalmente",