API Documentation

Tài liệu API HOẠT HÌNH 3D

Bố cục đã tối ưu để tra cứu nhanh endpoint, copy URL 1 chạm và test trực tiếp. Màu sắc đồng bộ theo toàn bộ giao diện theme hiện tại.

Danh sách phim Lấy danh sách phim theo các bộ lọc phổ biến.

Phim mới cập nhật

Danh sách phim vừa cập nhật gần nhất.

GET https://hh3d.cloudfle.top/api/films/phim-moi-cap-nhat?page={page}

Ví dụ: https://hh3d.cloudfle.top/api/films/phim-moi-cap-nhat?page=1

Chi tiết phim và tập Lấy metadata phim và danh sách tập theo slug.

Thông tin phim + danh sách tập

Trả về thông tin phim, diễn viên, đạo diễn, thể loại và episodes.

GET https://hh3d.cloudfle.top/api/phim/{slug}

Ví dụ: https://hh3d.cloudfle.top/api/phim/7-vien-ngoc-rong

Lọc theo thể loại / quốc gia Phù hợp khi làm trang catalog hoặc menu lọc.

Danh sách thể loại

Lấy toàn bộ thể loại để render menu/filter.

GET https://hh3d.cloudfle.top/api/the-loai

Ví dụ: https://hh3d.cloudfle.top/api/the-loai

Danh sách quốc gia

Lấy toàn bộ quốc gia để render menu/filter.

GET https://hh3d.cloudfle.top/api/quoc-gia

Ví dụ: https://hh3d.cloudfle.top/api/quoc-gia

Phim theo thể loại

Ví dụ slug: hanh-dong, vien-tuong, co-trang...

GET https://hh3d.cloudfle.top/api/films/the-loai/{slug}?page={page}

Ví dụ: https://hh3d.cloudfle.top/api/films/the-loai/hanh-dong?page=1

Phim theo quốc gia

Ví dụ slug: trung-quoc, han-quoc, nhat-ban...

GET https://hh3d.cloudfle.top/api/films/quoc-gia/{slug}?page={page}

Ví dụ: https://hh3d.cloudfle.top/api/films/quoc-gia/trung-quoc?page=1

Tìm kiếm Tìm phim theo tên hoặc slug.

Tìm kiếm phim

Query qua tham số keyword.

GET https://hh3d.cloudfle.top/api/films/search?keyword={keyword}&page={page}

Ví dụ: https://hh3d.cloudfle.top/api/films/search?keyword=Regeneration&page=1

Không tìm thấy endpoint phù hợp. Hãy thử từ khóa khác.

Mẫu phản hồi /api/the-loai

{
  "status": "success",
  "message": "",
  "data": {
    "items": [
      {
        "_id": "1",
        "name": "Hành Động",
        "slug": "hanh-dong"
      }
    ]
  }
}