Chuyển tới nội dung chính

Hướng dẫn nhanh

Đây là hướng dẫn nhanh để sử dụng AniMapper API. Để xem tài liệu chi tiết, xem Tài liệu API.

Base URL​

https://api.animapper.net/api/v1

Quy trình cơ bản​

1. Tìm kiếm Media​

Tìm kiếm anime hoặc manga:

GET /api/v1/search?title=attack&mediaType=ANIME&limit=10

Điều này trả về danh sách media khớp với tiêu chí tìm kiếm của bạn.

2. Lấy thông tin chi tiết Media​

Lấy thông tin chi tiết về một media cụ thể:

GET /api/v1/metadata?id=16498

Điều này trả về metadata toàn diện bao gồm tiêu đề, mô tả, hình ảnh, thể loại, và các provider streaming có sẵn.

3. Lấy danh sách tập​

Lấy danh sách tập từ một provider streaming:

GET /api/v1/stream/episodes?id=16498&provider=ANIMEVIETSUB

Điều này trả về tất cả các tập có sẵn cùng với ID tập của chúng.

4. Lấy nguồn stream​

Lấy URL stream cho một tập cụ thể:

GET /api/v1/stream/source?episodeData=shingeki-no-kyojin$12345&provider=ANIMEVIETSUB&server=DU

Điều này trả về URL stream mà bạn có thể sử dụng để phát tập phim.

Ví dụ hoàn chỉnh​

Đây là một ví dụ hoàn chỉnh bằng JavaScript:

// 1. Tìm kiếm media
const searchResponse = await fetch(
  'https://api.animapper.net/api/v1/search?title=attack&mediaType=ANIME&limit=1'
);
const searchData = await searchResponse.json();
const mediaId = searchData.results[0].id;

// 2. Lấy thông tin chi tiết media
const metadataResponse = await fetch(
  `https://api.animapper.net/api/v1/metadata?id=${mediaId}`
);
const metadata = await metadataResponse.json();

// 3. Lấy danh sách tập (sử dụng provider có sẵn đầu tiên)
const provider = Object.keys(metadata.result.streamingProviders)[0];
const episodesResponse = await fetch(
  `https://api.animapper.net/api/v1/stream/episodes?id=${mediaId}&provider=${provider}`
);
const episodes = await episodesResponse.json();

// 4. Lấy nguồn stream cho tập đầu tiên
const episodeData = episodes.episodes[0].episodeId;
const sourceResponse = await fetch(
  `https://api.animapper.net/api/v1/stream/source?episodeData=${episodeData}&provider=${provider}&server=DU`
);
const source = await sourceResponse.json();

console.log('Stream URL:', source.url);

Bước tiếp theo​

Giới hạn tốc độ​

API có giới hạn tốc độ (60 requests mỗi phút). Xem Giới hạn tốc độ để biết thêm chi tiết.