_

plugins/federations.js

@@ -333,5 +333,84 @@ FedsRoutes.post("/api/v2/federation/ban", authenticateApiKey, apiLimiter, async
     }
 });
 
+/**
+ * @swagger
+ * /api/v2/federation/ban-check:
+ *   post:
+ *     summary: Check if a user is banned in a federation
+ *     tags: [Federation]
+ *     description: Checks whether a user is banned in a specific federation using UUID and user ID.
+ *     security:
+ *       - apiKeyAuth: []
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               federation_uuid:
+ *                 type: string
+ *                 description: UUID of the federation.
+ *               user_id:
+ *                 type: integer
+ *                 description: User ID to check.
+ *     parameters:
+ *       - in: header
+ *         name: x-api-key
+ *         required: true
+ *         description: API key for authentication.
+ *         schema:
+ *           type: string
+ *     responses:
+ *       200:
+ *         description: Ban status of the user in the federation.
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 federation:
+ *                   type: string
+ *                   example: "AkenoX Federation"
+ *                 user_id:
+ *                   type: integer
+ *                   example: 12345
+ *                 is_banned:
+ *                   type: boolean
+ *                   example: true
+ *       400:
+ *         description: Missing federation UUID or invalid user ID.
+ *       404:
+ *         description: Federation not found.
+ *       500:
+ *         description: Internal server error.
+ */
+FedsRoutes.post("/api/v2/federation/ban-check", authenticateApiKey, async (req, res) => {
+  try {
+    const { federation_uuid, user_id } = req.body;
+
+    if (!federation_uuid || !user_id || isNaN(user_id)) {
+      return res.status(400).json({ error: "Federation UUID and valid user ID required." });
+    }
+
+    const federation = await Federation.findOne({ uuid: federation_uuid });
+
+    if (!federation) {
+      return res.status(404).json({ error: "Federation not found." });
+    }
+
+    const isBanned = federation.banned_users.includes(user_id);
+
+    res.json({ 
+      federation: federation.name, 
+      user_id, 
+      is_banned: isBanned 
+    });
+
+  } catch (error) {
+    res.status(500).json({ error: `Failed to check ban status: ${error.message}` });
+  }
+});
 
 export { FedsRoutes };