mirror of
https://github.com/Shineii86/AniKotoAPI.git
synced 2026-10-22 10:55:10 +00:00
Shinei Nouzen
fd29b02158
New Endpoints (4 new routes): - GET /api/upcoming — upcoming anime releases from homepage - GET /api/top-rankings?sort=top|newest — ranked anime with sort modes - GET /api/recently-updated?tab=all|dub|sub — filtered recent updates - GET /api/completed — finished anime series from homepage Enhanced Filter (/api/filter): - Added source parameter (18 source material types) - Added epMin/epMax for episode range filtering - Added excludeWatchlist parameter for logged-in users - Added season parameter (spring/summer/fall/winter) New Config IDs: - SOURCE_IDS: 18 source material type mappings - SEASON_IDS: 4 broadcast season mappings - EXTENDED_TYPE_IDS: Added tv-short and tv-special types Total endpoints: 34 (was 30) OpenAPI spec updated with new endpoints CHANGELOG.md updated with comprehensive change history
301 lines
11 KiB
JavaScript
301 lines
11 KiB
JavaScript
/*
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
* AniKotoAPI — ids.config.js
|
|
* Repository: https://github.com/Shineii86/AniKotoAPI
|
|
*
|
|
* @description
|
|
* Mapping configuration for anime metadata IDs used by the AniKoto
|
|
* site's filtering system. Contains human-readable slugs mapped
|
|
* to numeric IDs for genres, types, statuses, ratings, and sort options.
|
|
*
|
|
* @exports
|
|
* GENRE_IDS, TYPE_IDS, STATUS_IDS, RATING_IDS, SORT_IDS
|
|
*
|
|
* @author Shinei Nouzen
|
|
* @license MIT
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
*/
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// GENRE ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Genre slug to numeric ID mapping ----
|
|
/**
|
|
* Maps human-readable genre slugs to their corresponding numeric IDs
|
|
* used in AniKoto's filtering system. Contains 43 different anime genres
|
|
* from action to vampire.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} action - ID for action genre
|
|
* @property {string} adventure - ID for adventure genre
|
|
* @property {string} comedy - ID for comedy genre
|
|
* @property {string} drama - ID for drama genre
|
|
* @property {string} fantasy - ID for fantasy genre
|
|
* @property {string} horror - ID for horror genre
|
|
* @property {string} romance - ID for romance genre
|
|
* @property {string} sci-fi - ID for science fiction genre
|
|
* @property {string} slice-of-life - ID for slice of life genre
|
|
* @property {string} supernatural - ID for supernatural genre
|
|
*
|
|
* @example
|
|
* // Get genre ID for filtering
|
|
* GENRE_IDS["action"] // "1"
|
|
* GENRE_IDS["comedy"] // "4"
|
|
*/
|
|
const GENRE_IDS = {
|
|
"action": "1",
|
|
"adventure": "2",
|
|
"cars": "3",
|
|
"comedy": "4",
|
|
"dementia": "5",
|
|
"demons": "6",
|
|
"drama": "7",
|
|
"ecchi": "8",
|
|
"fantasy": "9",
|
|
"game": "10",
|
|
"harem": "11",
|
|
"historical": "12",
|
|
"horror": "13",
|
|
"isekai": "14",
|
|
"josei": "15",
|
|
"kids": "16",
|
|
"magic": "17",
|
|
"mahou-shoujo": "18",
|
|
"martial-arts": "19",
|
|
"mecha": "20",
|
|
"military": "21",
|
|
"music": "22",
|
|
"mystery": "23",
|
|
"parody": "24",
|
|
"police": "25",
|
|
"psychological": "26",
|
|
"romance": "27",
|
|
"samurai": "28",
|
|
"school": "29",
|
|
"sci-fi": "30",
|
|
"seinen": "31",
|
|
"shoujo": "32",
|
|
"shoujo-ai": "33",
|
|
"shounen": "34",
|
|
"shounen-ai": "35",
|
|
"slice-of-life": "36",
|
|
"space": "37",
|
|
"sports": "38",
|
|
"super-power": "39",
|
|
"supernatural": "40",
|
|
"thriller": "41",
|
|
"unknown": "42",
|
|
"vampire": "43"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// ANIME TYPE ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Anime type slug to numeric ID mapping ----
|
|
/**
|
|
* Maps anime type slugs to their corresponding numeric IDs.
|
|
* Covers all standard anime format types including TV series,
|
|
* movies, OVAs, ONAs, and special episodes.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} movie - ID for movie format
|
|
* @property {string} music - ID for music video format
|
|
* @property {string} ona - ID for Original Net Animation
|
|
* @property {string} ova - ID for Original Video Animation
|
|
* @property {string} special - ID for special episodes
|
|
* @property {string} tv - ID for TV broadcast series
|
|
*
|
|
* @example
|
|
* // Get type ID for filtering
|
|
* TYPE_IDS["tv"] // "6"
|
|
* TYPE_IDS["movie"] // "1"
|
|
*/
|
|
const TYPE_IDS = {
|
|
"movie": "1",
|
|
"music": "2",
|
|
"ona": "3",
|
|
"ova": "4",
|
|
"special": "5",
|
|
"tv": "6"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// AIRING STATUS ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Airing status slug to numeric ID mapping ----
|
|
/**
|
|
* Maps anime airing status slugs to their corresponding numeric IDs.
|
|
* Used to filter anime by their broadcast completion status.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} currently-airing - ID for ongoing series
|
|
* @property {string} finished-airing - ID for completed series
|
|
* @property {string} not-yet-aired - ID for upcoming series
|
|
*
|
|
* @example
|
|
* // Get status ID for filtering
|
|
* STATUS_IDS["currently-airing"] // "1"
|
|
*/
|
|
const STATUS_IDS = {
|
|
"currently-airing": "1",
|
|
"finished-airing": "2",
|
|
"not-yet-aired": "3"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// AGE RATING ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Age rating slug to numeric ID mapping ----
|
|
/**
|
|
* Maps age rating slugs to their corresponding numeric IDs.
|
|
* Follows standard anime age rating classifications from
|
|
* general audience to restricted content.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} g - ID for General Audiences
|
|
* @property {string} pg - ID for Parental Guidance
|
|
* @property {string} pg-13 - ID for Parents Strongly Cautioned
|
|
* @property {string} r - ID for Restricted
|
|
* @property {string} r+ - ID for Restricted Plus
|
|
* @property {string} rx - ID for Hentai (Adult)
|
|
*
|
|
* @example
|
|
* // Get rating ID for filtering
|
|
* RATING_IDS["pg-13"] // "3"
|
|
*/
|
|
const RATING_IDS = {
|
|
"g": "1",
|
|
"pg": "2",
|
|
"pg-13": "3",
|
|
"r": "4",
|
|
"r+": "5",
|
|
"rx": "6"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// SORT ORDER ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Sort order slug to query parameter mapping ----
|
|
/**
|
|
* Maps sort order slugs to their corresponding query parameter values.
|
|
* Used with the filter/search endpoint to control result ordering.
|
|
* Note: Default sort has empty string value.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} default - Default sort order (empty string)
|
|
* @property {string} latest-updated - ID for most recently updated
|
|
* @property {string} latest-added - ID for most recently added
|
|
* @property {string} score - ID for highest rated
|
|
* @property {string} name-az - ID for alphabetical order
|
|
* @property {string} release-date - ID for newest release date
|
|
* @property {string} most-viewed - ID for most popular
|
|
* @property {string} number_of_episodes - ID for episode count
|
|
*
|
|
* @example
|
|
* // Get sort parameter value
|
|
* SORT_IDS["latest-updated"] // "1"
|
|
* SORT_IDS["score"] // "3"
|
|
*/
|
|
const SORT_IDS = {
|
|
"default": "",
|
|
"latest-updated": "1",
|
|
"latest-added": "2",
|
|
"score": "3",
|
|
"name-az": "4",
|
|
"release-date": "5",
|
|
"most-viewed": "6",
|
|
"number_of_episodes": "7"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// SOURCE TYPE ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Source type slug to numeric ID mapping ----
|
|
/**
|
|
* Maps anime source type slugs to their corresponding numeric IDs.
|
|
* Used to filter anime by their original source material.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} manga - ID for manga source
|
|
* @property {string} light-novel - ID for light novel source
|
|
* @property {string} original - ID for original work
|
|
* @property {string} visual-novel - ID for visual novel source
|
|
* @property {string} game - ID for game source
|
|
* @property {string} 4-koma-manga - ID for 4-koma manga source
|
|
*
|
|
* @example
|
|
* // Get source ID for filtering
|
|
* SOURCE_IDS["manga"] // "6"
|
|
* SOURCE_IDS["original"] // "10"
|
|
*/
|
|
const SOURCE_IDS = {
|
|
"4-koma-manga": "1",
|
|
"book": "2",
|
|
"card-game": "3",
|
|
"game": "4",
|
|
"light-novel": "5",
|
|
"manga": "6",
|
|
"mixed-media": "7",
|
|
"music": "8",
|
|
"novel": "9",
|
|
"original": "10",
|
|
"other": "11",
|
|
"picture-book": "12",
|
|
"radio": "13",
|
|
"unknown": "14",
|
|
"video-game": "15",
|
|
"visual-novel": "16",
|
|
"web-manga": "17",
|
|
"web-novel": "18"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// SEASON ID MAPPING
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Season slug to ID mapping ----
|
|
/**
|
|
* Maps anime season slugs to their corresponding IDs.
|
|
* Used to filter anime by their broadcast season.
|
|
*
|
|
* @type {Object}
|
|
* @property {string} spring - ID for spring season
|
|
* @property {string} summer - ID for summer season
|
|
* @property {string} fall - ID for fall season
|
|
* @property {string} winter - ID for winter season
|
|
*
|
|
* @example
|
|
* // Get season ID for filtering
|
|
* SEASON_IDS["spring"] // "1"
|
|
*/
|
|
const SEASON_IDS = {
|
|
"spring": "1",
|
|
"summer": "2",
|
|
"fall": "3",
|
|
"winter": "4"
|
|
};
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// TV-SPECIFIC TYPE IDS
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Extended type slug to numeric ID mapping ----
|
|
/**
|
|
* Extended type mappings including TV-specific formats.
|
|
*
|
|
* @type {Object}
|
|
*/
|
|
const EXTENDED_TYPE_IDS = {
|
|
...TYPE_IDS,
|
|
"tv-short": "7",
|
|
"tv-special": "8"
|
|
};
|
|
|
|
export { GENRE_IDS, TYPE_IDS, STATUS_IDS, RATING_IDS, SORT_IDS, SOURCE_IDS, SEASON_IDS, EXTENDED_TYPE_IDS };
|
|
// ══════════════════════════════════════════════════════════════ END: ids.config.js
|