AnimeVietSub

Hướng dẫn chi tiết về cách sử dụng provider AnimeVietSub trong AniMapper API.

Định dạng Episode Data

episodeId từ response episodes có định dạng: {mediaId}${episodeId}

Sử dụng giá trị này trực tiếp làm tham số episodeData cho endpoint source.

Ví dụ:

• Nếu episodeId là "shingeki-no-kyojin$12345"
• Sử dụng như: episodeData=shingeki-no-kyojin$12345

Các Server có sẵn

Server	Loại	Mô tả
DU	HLS	Stream HLS chất lượng cao (mặc định)
HDX	EMBED	URL embed player

Server DU (HLS)

Đặc điểm:

• Trả về URL endpoint M3U8 đã cache
• Nội dung M3U8 được giải mã và cache trong 24 giờ
• Cache key là hash SHA-256 của episodeData
• Yêu cầu CORS proxy headers

Cách sử dụng:

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

Response:

{
  "server": "DU",
  "type": "HLS",
  "corsProxyRequired": true,
  "proxyHeaders": {
    "Referer": "https://animevietsub.page"
  },
  "url": "https://api.animapper.net/api/v1/stream/source/m3u8/abc123def456"
}

Lưu ý: Các link stream của server DU có thể xem trực tiếp nhưng yêu cầu CORS proxy để tương thích với môi trường client (trình duyệt). Bạn nên cấu hình máy chủ hoặc sử dụng dịch vụ proxy đảm bảo CORS để có thể sử dụng stream từ AnimeVietSub.

Server HDX (Embed)

Đặc điểm:

• Trả về URL embed player trực tiếp
• Không yêu cầu CORS proxy
• Phù hợp cho iframe embedding

Cách sử dụng:

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

Response:

{
  "server": "HDX",
  "type": "EMBED",
  "corsProxyRequired": false,
  "proxyHeaders": null,
  "url": "https://embed.example.com/player?id=12345"
}

Cache M3U8

Thông tin cache:

• Nội dung M3U8 được tự động cache
• Thời gian cache: 24 giờ
• Giới hạn kích thước cache: 1000 entries
• Truy cập nội dung đã cache qua /api/v1/stream/source/m3u8/{cacheKey}

Ví dụ:

GET /api/v1/stream/source/m3u8/abc123def456

Lưu ý

• ⚠️ Lưu ý về Mapping: Do đa số mapping được thực hiện tự động, có thể xảy ra trường hợp mapping sai hoặc thiếu. Nếu bạn phát hiện mapping không chính xác hoặc thiếu provider cho một media, vui lòng tham gia Discord của chúng tôi để góp ý và yêu cầu chỉnh sửa.
• Server mặc định là DU nếu không chỉ định server
• Nếu server ưu tiên không khả dụng, hệ thống sẽ tự động chuyển sang server có sẵn đầu tiên