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
222 lines
7.9 KiB
Markdown
222 lines
7.9 KiB
Markdown
# Architecture
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
AniKotoAPI/
|
|
├── server.js # Express entry point, port 4444
|
|
├── package.json # name: "AniKotoAPI"
|
|
├── vercel.json # Routes /api/* and /* to server.js
|
|
├── .env # Configuration (see .env.example)
|
|
│
|
|
├── public/ # Static files served from process.cwd()
|
|
│ ├── index.html # Premium landing page (56KB, SVG icons, live console)
|
|
│ ├── 404.html # Glitch animation error page
|
|
│ ├── manifest.json # PWA manifest (theme: #A855F7)
|
|
│ ├── robots.txt # Crawler directives
|
|
│ ├── sitemap.xml # 4 pages (/, /tos, /privacy, /api)
|
|
│ ├── og-image.svg # SVG Open Graph image
|
|
│ ├── privacy.html # Privacy policy (served at /privacy)
|
|
│ └── tos.html # Terms of service (served at /tos)
|
|
│
|
|
├── docs/ # API documentation
|
|
│ ├── index.md # Overview, quick start, features
|
|
│ ├── endpoints.md # Full API reference (33 endpoints)
|
|
│ ├── streaming.md # Streaming flow guide (3-step)
|
|
│ ├── examples.md # cURL, JavaScript, Python, Node.js
|
|
│ └── architecture.md # This file
|
|
│
|
|
├── src/
|
|
│ ├── configs/
|
|
│ │ ├── dataUrl.js # URL patterns, BASE_URL: https://anikototv.to
|
|
│ │ ├── header.config.js # Request headers (User-Agent, Referer, etc.)
|
|
│ │ └── ids.config.js # Genre/type/status ID mappings
|
|
│ │
|
|
│ ├── routes/
|
|
│ │ ├── apiRoutes.js # All route definitions + OpenAPI spec
|
|
│ │ └── category.route.js # genre/:name, type/:name, status/:name
|
|
│ │
|
|
│ ├── controllers/
|
|
│ │ ├── homeInfo.controller.js # Homepage data
|
|
│ │ ├── search.controller.js # Anime search
|
|
│ │ ├── animeInfo.controller.js # Anime info
|
|
│ │ ├── episodeList.controller.js # Episode list
|
|
│ │ ├── servers.controller.js # Server list
|
|
│ │ ├── stream.controller.js # Stream URL
|
|
│ │ ├── suggestion.controller.js # Anime suggestions
|
|
│ │ ├── spotlight.controller.js # Spotlight anime
|
|
│ │ ├── trending.controller.js # Trending anime
|
|
│ │ ├── topten.controller.js # Top 10
|
|
│ │ ├── schedule.controller.js # Schedule
|
|
│ │ ├── random.controller.js # Random anime
|
|
│ │ ├── newRelease.controller.js # New releases + Latest Updated
|
|
│ │ ├── popular.controller.js # Most popular
|
|
│ │ ├── category.controller.js # Genre filter
|
|
│ │ ├── category.controller.js # Type filter
|
|
│ │ ├── category.controller.js # Status filter
|
|
│ │ └── filter.controller.js # Advanced filter
|
|
│ │
|
|
│ ├── extractors/
|
|
│ │ ├── home.extractor.js # Homepage extraction
|
|
│ │ ├── search.extractor.js # Search results
|
|
│ │ ├── info.extractor.js # Anime details
|
|
│ │ ├── episodeList.extractor.js # Episode list + server_ids
|
|
│ │ ├── serverList.extractor.js # Server list
|
|
│ │ ├── streamInfo.extractor.js # Stream URL extraction
|
|
│ │ ├── spotlight.extractor.js # Spotlight anime
|
|
│ │ ├── trending.extractor.js # Trending anime
|
|
│ │ ├── topTen.extractor.js # Top 10
|
|
│ │ ├── schedule.extractor.js # Schedule
|
|
│ │ ├── random.extractor.js # Random anime
|
|
│ │ ├── newRelease.extractor.js # New releases + Latest Updated
|
|
│ │ ├── mostPopular.extractor.js # Most popular
|
|
│ │ ├── genre.extractor.js # Genre filter
|
|
│ │ ├── type.extractor.js # Type filter
|
|
│ │ ├── status.extractor.js # Status filter
|
|
│ │ ├── filter.extractor.js # Advanced filter
|
|
│ │ ├── suggestion.extractor.js # Suggestions
|
|
│ │ ├── seasons.extractor.js # Seasons/OVAs/movies
|
|
│ │ ├── watchOrder.extractor.js # Watch order
|
|
│ │ └── download.extractor.js # Download links
|
|
│ │
|
|
│ └── helper/
|
|
│ ├── cache.helper.js # LRU cache with configurable TTL
|
|
│ ├── mirror.helper.js # Multi-mirror fallback (5 domains)
|
|
│ └── extractPages.helper.js # Page fetching with mirror fallback
|
|
│
|
|
├── test.js # Test suite (27 tests)
|
|
├── agents/ # AI agent prompts (6 agents)
|
|
└── CHANGELOG.md # Version history
|
|
```
|
|
|
|
## Tech Stack
|
|
|
|
| Component | Technology |
|
|
|-----------|------------|
|
|
| Runtime | Node.js |
|
|
| Framework | Express.js |
|
|
| Scraping | Cheerio + Axios |
|
|
| Deployment | Vercel (Serverless) |
|
|
| Caching | LRU cache with configurable TTL |
|
|
| Compression | gzip (level 6, 1024 byte threshold) |
|
|
| Mirror Fallback | 5 mirror domains with health checks |
|
|
| Static Files | Express static middleware |
|
|
|
|
## Request Flow
|
|
|
|
```
|
|
Client Request
|
|
↓
|
|
Vercel Routes (/api/* → server.js)
|
|
↓
|
|
Express Router (apiRoutes.js)
|
|
↓
|
|
Controller (e.g., search.controller.js)
|
|
↓
|
|
Extractor (e.g., search.extractor.js)
|
|
↓
|
|
HTTP Request to anikototv.to (with headers)
|
|
↓
|
|
Cheerio parses HTML response
|
|
↓
|
|
Returns structured JSON
|
|
↓
|
|
Client Response
|
|
```
|
|
|
|
## Streaming Flow
|
|
|
|
```
|
|
/api/episodes/:slug
|
|
↓
|
|
Returns: server_ids, animeId, totalEpisodes
|
|
↓
|
|
/api/servers?ids={server_ids}
|
|
↓
|
|
Returns: link_id, type (sub/dub), name (HD-1, Vidstream-2, etc.)
|
|
↓
|
|
/api/stream?id={link_id}
|
|
↓
|
|
Returns: url (stream link), skipData (intro/outro timestamps)
|
|
```
|
|
|
|
## Caching Strategy
|
|
|
|
- **Type:** In-memory Map
|
|
- **TTL:** 5 minutes (300,000ms)
|
|
- **Key:** Full request URL
|
|
- **Behavior:** First request fetches from source, subsequent requests served from cache
|
|
- **Reset:** TTL resets on each access
|
|
- **Eviction:** Automatic when TTL expires
|
|
|
|
## Anti-Bot Protection
|
|
|
|
The source site monitors AJAX responses for missing `data-ep-id` and `data-link-id` attributes. If these are missing in the `/ajax/server/list` response, it triggers a reCAPTCHA challenge.
|
|
|
|
**Solution:** The API properly passes `data-ids` to the server list endpoint and parses the JSON response to extract the required attributes.
|
|
|
|
## Vercel Configuration
|
|
|
|
```json
|
|
{
|
|
"version": 2,
|
|
"builds": [
|
|
{
|
|
"src": "server.js",
|
|
"use": "@vercel/node"
|
|
}
|
|
],
|
|
"routes": [
|
|
{
|
|
"src": "/api/(.*)",
|
|
"dest": "server.js"
|
|
},
|
|
{
|
|
"src": "/(.*)",
|
|
"dest": "server.js"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
- `/api/*` routes to Express for API handling
|
|
- `/*` routes to Express for static file serving
|
|
- Static files served from `process.cwd()` (Vercel serverless compatible)
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `ANIKOTO_CHECK_SERVER_TS` | Anti-bot check timestamp from source site |
|
|
|
|
## Response Format
|
|
|
|
All API responses follow this structure:
|
|
|
|
```json
|
|
{
|
|
"success": true,
|
|
"results": { ... }
|
|
}
|
|
```
|
|
|
|
Error responses:
|
|
|
|
```json
|
|
{
|
|
"success": false,
|
|
"message": "Error description"
|
|
}
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
| Package | Version | Purpose |
|
|
|---------|---------|---------|
|
|
| express | ^4.21.0 | Web framework |
|
|
| cheerio | ^1.0.0-rc.12 | HTML parsing |
|
|
| axios | ^1.8.0 | HTTP requests |
|
|
| cors | ^2.8.5 | CORS headers |
|
|
| cookie-parser | ^1.4.7 | Cookie parsing |
|
|
| dotenv | ^16.4.0 | Environment variables |
|