mirror of
https://github.com/Shineii86/AniKotoAPI.git
synced 2026-10-22 10:55:10 +00:00
Shinei Nouzen
fe51275db0
- Add multi-mirror fallback system with 5 mirror domains - Add LRU cache with configurable TTL per endpoint - Add response compression (gzip) - Add Seasons endpoint (/api/seasons/:id) - Add Watch Order endpoint (/api/watch-order/:id) - Add Latest Updated endpoint (/api/latest-updated) - Add Download endpoint (/api/download) - Add cache stats endpoint (/api/cache/stats) - Add mirror status/reset endpoints (/api/mirrors, /api/mirrors/reset) - Add configurable rate limiting with X-RateLimit headers - Add request timeouts and entity too large handling - Update documentation with all new endpoints - Update CHANGELOG.md with v2.0.0 entry - Update package.json version to 2.0.0 - Add 6 AI agent prompts for development
59 lines
2.3 KiB
JavaScript
59 lines
2.3 KiB
JavaScript
/*
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
* AniKotoAPI — popular.controller.js
|
|
* Repository: https://github.com/Shineii86/AniKotoAPI
|
|
*
|
|
* @description
|
|
* Controller for most popular anime list. Returns paginated list
|
|
* of the most popular anime from the source site. Supports page
|
|
* parameter for pagination.
|
|
*
|
|
* @exports
|
|
* getPopular - Express route handler for GET /api/most-popular
|
|
*
|
|
* @author Shinei Nouzen
|
|
* @license MIT
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
*/
|
|
|
|
import { extractPopular } from "../extractors/popular.extractor.js";
|
|
import { getCache, setCache, TTL } from "../helper/cache.helper.js";
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// CONTROLLER: POPULAR
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Most popular anime endpoint ----
|
|
/**
|
|
* Handles GET /api/most-popular requests. Returns paginated list
|
|
* of the most popular anime from the source site.
|
|
*
|
|
* @param {object} req - Express request object
|
|
* @param {number} req.query.page - Page number (default: 1)
|
|
* @param {object} res - Express response object
|
|
* @param {Function} next - Express next middleware function
|
|
* @returns {void} Sends JSON response with popular anime list
|
|
*
|
|
* @example
|
|
* GET /api/most-popular?page=2
|
|
* Response: { success: true, results: { anime, pagination, ... } }
|
|
*/
|
|
const getPopular = async (req, res, next) => {
|
|
try {
|
|
const { page = 1 } = req.query;
|
|
const cacheKey = `popular_${page}`;
|
|
const cached = getCache(cacheKey);
|
|
if (cached) {
|
|
return res.json({ success: true, results: cached });
|
|
}
|
|
const data = await extractPopular(page);
|
|
setCache(cacheKey, data, TTL.default);
|
|
res.json({ success: true, results: data });
|
|
} catch (error) {
|
|
next(error);
|
|
}
|
|
};
|
|
|
|
export { getPopular };
|
|
|
|
// ══════════════════════════════════════════════════════════════ END: popular.controller.js
|