v2.3.0: Update docs with streaming status, bump version, add solutions

This commit is contained in:
Shinei Nouzen
2026-08-14 07:39:50 +05:30
parent 03b68481b4
commit 426559d0de
8 changed files with 103 additions and 10 deletions
+3 -3
View File
@@ -1,8 +1,8 @@
/**
* ============================================================================
* AniKotoAPI — Architecture Document
* Version : 2.2.1
* Generated: 2026-07-30
* Version : 2.3.0
* Generated: 2026-08-14
* ============================================================================
*
* Free REST API for scraping anime data from anikototv.to
@@ -832,7 +832,7 @@
* │ VERSION HISTORY │
* ├──────────────────────────────────────────────────────────────────────┤
* │ │
* │ v2.2.1 (Current) │
* │ v2.3.0 (Current) │
* │ • 28 endpoints, 28 extractors │
* │ • LRU cache with per-endpoint TTL │
* │ • 5-mirror failover system │
+26 -1
View File
@@ -4,6 +4,31 @@ Base URL: `https://anikototvapi.vercel.app/api`
---
## ⚠️ Streaming Status
> **Streaming endpoints (`/api/servers`, `/api/stream`, `/api/stream/resolve`) return errors when anikototv.to blocks AJAX requests from server-side IPs.**
| What Works | What's Blocked |
|:---|:---|
| Home, spotlight, trending | `/api/servers` — server list |
| Search, suggestions, filter | `/api/stream` — embed URLs |
| Info, episodes, schedule | `/api/stream/resolve` — m3u8/mp4 |
| Top 10, most popular, new release | `/api/mapper-servers` — gogoanime servers |
| AZ list, random, genre list | All AJAX-dependent endpoints |
| All HTML-scraped endpoints | |
**To fix streaming**, set one of these environment variables:
```bash
# Option 1: ScraperAPI (requires premium plan — $49/month)
SCRAPER_API_KEY=your_scraperapi_key
# Option 2: FlareSolverr (self-hosted, unlimited)
FLARESOLVERR_URL=http://your-flaresolverr-host:8191
```
---
## Pagination
Most list endpoints return a `totalPages` field for pagination:
@@ -859,7 +884,7 @@ curl "https://anikototvapi.vercel.app/api/health"
"success": true,
"results": {
"status": "healthy",
"version": "2.2.1",
"version": "2.3.0",
"uptime": "0h 1m 21s",
"uptimeSeconds": 81,
"timestamp": "2026-07-30T02:20:46.153Z",
+2 -2
View File
@@ -26,7 +26,7 @@ curl -s "https://anikototvapi.vercel.app/api/health" | python3 -m json.tool
"success": true,
"results": {
"status": "healthy",
"version": "2.2.1",
"version": "2.3.0",
"uptime": "0h 1m 21s",
"uptimeSeconds": 81,
"timestamp": "2026-07-30T02:20:46.153Z",
@@ -2036,7 +2036,7 @@ curl -s "https://anikototvapi.vercel.app/api/health" | python3 -m json.tool
"success": true,
"results": {
"status": "healthy",
"version": "2.2.1",
"version": "2.3.0",
"uptime": "0h 1m 21s",
"uptimeSeconds": 81,
"timestamp": "2026-07-30T02:20:46.153Z",
+27 -2
View File
@@ -1,11 +1,11 @@
# // === HEADER ===
# AniKotoAPI v2.2.1
# AniKotoAPI v2.3.0
# Free REST API for Anime Data
# Scraping anikototv.to with Cheerio
---
![AniKotoAPI](https://img.shields.io/badge/AniKotoAPI-v2.2.1-blue)
![AniKotoAPI](https://img.shields.io/badge/AniKotoAPI-v2.3.0-blue)
![License](https://img.shields.io/badge/License-MIT-green)
![Endpoints](https://img.shields.io/badge/Endpoints-38+-orange)
![Node.js](https://img.shields.io/badge/Node.js-18+-brightgreen)
@@ -15,6 +15,31 @@
---
## // === STREAMING STATUS ===
> **Streaming endpoints (`/api/servers`, `/api/stream`, `/api/stream/resolve`) return errors when anikototv.to blocks AJAX requests from server-side IPs.**
| What Works | What's Blocked |
|:---|:---|
| Home, spotlight, trending | `/api/servers` — server list |
| Search, suggestions, filter | `/api/stream` — embed URLs |
| Info, episodes, schedule | `/api/stream/resolve` — m3u8/mp4 |
| Top 10, most popular, new release | `/api/mapper-servers` — gogoanime servers |
| AZ list, random, genre list | All AJAX-dependent endpoints |
| All HTML-scraped endpoints | |
**To fix streaming**, set one of these environment variables:
```bash
# Option 1: ScraperAPI (requires premium plan — $49/month)
SCRAPER_API_KEY=your_scraperapi_key
# Option 2: FlareSolverr (self-hosted, unlimited)
FLARESOLVERR_URL=http://your-flaresolverr-host:8191
```
---
## // === QUICK START ===
### Get started in 3 steps:
+25
View File
@@ -12,6 +12,31 @@ This document covers the complete streaming workflow for AniKotoAPI — from sea
---
## ⚠️ Streaming Status
> **Streaming endpoints (`/api/servers`, `/api/stream`, `/api/stream/resolve`) return errors when anikototv.to blocks AJAX requests from server-side IPs.**
| What Works | What's Blocked |
|:---|:---|
| Home, spotlight, trending | `/api/servers` — server list |
| Search, suggestions, filter | `/api/stream` — embed URLs |
| Info, episodes, schedule | `/api/stream/resolve` — m3u8/mp4 |
| Top 10, most popular, new release | `/api/mapper-servers` — gogoanime servers |
| AZ list, random, genre list | All AJAX-dependent endpoints |
| All HTML-scraped endpoints | |
**To fix streaming**, set one of these environment variables:
```bash
# Option 1: ScraperAPI (requires premium plan — $49/month)
SCRAPER_API_KEY=your_scraperapi_key
# Option 2: FlareSolverr (self-hosted, unlimited)
FLARESOLVERR_URL=http://your-flaresolverr-host:8191
```
---
## Table of Contents
1. [Architecture Overview](#architecture-overview)