🐱 Neko API Proxy
Cổng JSON nhỏ cho NekoAVS (anime), NekoDex (manga: MangaDex, TruyenQQ) và NekoNovel (novel: Hako). Frontend chỉ gọi cổng này; cổng này gọi các nguồn đã được duyệt, chuẩn hóa dữ liệu và xử lý CORS, cache, giới hạn tham số.
Endpoint (chỉ GET)
/api/health | Kiểm tra trạng thái. |
/api/providers | Danh sách nguồn, bộ lọc và nhóm trang chủ mỗi nguồn hỗ trợ. |
/api/anime/{nguồn}/list | Danh sách/tìm kiếm anime (q, category, country, year, sort, page). |
/api/anime/{nguồn}/detail/{slug} | Chi tiết và tập phim (link embed của nguồn). |
/api/manga/{nguồn}/… | list, detail/{id}, chapters/{id}, read/{chapterId}, tags, img?u= (ảnh MangaDex/TruyenQQ). |
/api/novel/{nguồn}/… | list, detail/{id}, chapters/{id}, read/{chapterId}, tags (Hako). |
Nguyên tắc
Anime/phim: chỉ chuyển JSON metadata; ảnh và trình phát tải trực tiếp từ nguồn. Ảnh MangaDex và TruyenQQ (bìa, trang truyện) được chuyển tiếp qua /api/manga/{nguồn}/img vì nguồn bắt buộc proxy/không cho hotlink: proxy chỉ cho host ảnh đã biết và không lưu lâu dài. TruyenQQ cần Referer của chính trang nguồn khi tải ảnh; Worker không chuyển cookie hay credential của người dùng. Với tìm kiếm TruyenQQ, Worker tự lấy cookie phiên công khai của trang nguồn. Hako là nguồn novel HTML; nội dung chữ được đọc và giải mã theo cơ chế của Hako với sự cho phép của họ, API luôn kèm credit Hako và nhóm dịch. Ảnh bìa/minh hoạ Hako trả URL trực tiếp vì CDN cho phép hotlink. Không giả mạo header để vượt giới hạn truy cập. Chỉ các origin được cấu hình mới gọi được từ trình duyệt. Quyền sở hữu nội dung thuộc về nguồn và nhóm dịch; vui lòng ghi nguồn khi hiển thị.