Hướng dẫn sử dụng API AniMapper

Endpoint hiện tại: https://api.animapper.net/api/v1/

Dưới đây là hướng dẫn cách sử dụng 3 endpoint chính trong AniMapper:

• /search
• /episodes
• /source

1. Search

GET /search?id={anilistId}

Mục đích: Tìm kiếm thông tin anime dựa trên mã Anilist.

Bảng tham số:

Tên tham số	Bắt buộc	Mô tả
id	Có	Mã Anilist của bộ anime cần tìm kiếm

Kết quả trả về:

{
  "sucess": true,
  "result": {
    "anilistId": "ANILIST_ID",
    "providers": [
      {
        "provider": "PROVIDER_ID",
        "sourceId": "SOURCE_ID"
      }
      // ... có thể có thêm nhiều provider
    ]
  }
}

2. Episodes

GET /episodes?id={sourceId}&provider={provider}&limit={limit}&offset={offset}

Mục đích: Lấy danh sách tập phim từ một sourceId cụ thể, do provider quản lý.

Bảng tham số:

Tên tham số	Bắt buộc	Mặc định	Mô tả
id	Có	–	Mã nguồn do provider quản lý (VD: "a4929")
provider	Có	–	Tên provider (VD: "ANIMEVIETSUB")
limit	Không	12	Số lượng tập cần lấy (không vượt quá 12, không được âm)
offset	Không	0	Vị trí bắt đầu lấy tập (không được âm)

Kết quả trả về:

{
  "provider": "PROVIDER_ID",
  "limit": 12,
  "offset": 0,
  "total": 12,
  "hasNextPage": false,
  "episodes": [
    {
      "episodeNumber": "EPISODE_NUMBER",
      "episodeId": "EPISODE_ID"
    }
  ]
}

3. Source

GET /source?episodeData={episodeData}&provider={provider}

Mục đích: Truy xuất đường dẫn stream/video nhúng cho một tập phim cụ thể.

Bảng tham số:

Tên tham số	Bắt buộc	Mô tả
episodeData	Có	Chuỗi thông tin mã nguồn của tập (lấy từ sourceId trong mảng sources)
provider	Có	Tên provider (VD: "ANIMEVIETSUB")

Kết quả trả về: Dữ liệu trả về sẽ phụ thuộc vào từng provider, nhưng thường sẽ có dạng:

{
  "server": "SERVER_NAME",
  "type": "SOURCE_TYPE",
  "corsProxyRequired": false,
  "proxyHeaders": {
    "Origin": "ORIGIN_URL",
    "Referer": "REFERER_URL",
    ...
  },
  "url": "SOURCE_URL/DATA/...."
}