Tài liệu API
Gốc API: https://api.phimnganapi.com. Mọi phản hồi là JSON.
| Endpoint | Mô tả |
|---|---|
GET /v1/movies?page=&limit=&genre=&mood=&channel=&audio= | Danh sách phim có nguồn phát, 36 phim/trang (tối đa 64). Trả về total để phân trang. |
GET /v1/movies/{slug} | Chi tiết phim: tập (theo audio), diễn viên/đạo diễn, phim liên quan. |
GET /v1/movies/changes | Luồng thay đổi theo keyset cho đồng bộ. |
GET /v1/movies/removed | Luồng phim bị ẩn/xoá để bên nhận gỡ khỏi chỉ mục. |
GET /v1/persons?page=&limit= | Diễn viên có ít nhất một phim công khai. |
GET /v1/persons/{slug} | Hồ sơ diễn viên và toàn bộ phim công khai. Tên khác trả 301 về slug chính. |
GET /v1/search?q=&page=&limit=&genre=&audio=&content= | Tìm theo tên phim (2–100 ký tự), phân trang ổn định theo ngày tạo và id; dùng các bộ lọc cùng danh mục. Trả về page, limit, total, items. |
GET /v1/facets/{genres|moods|channels} | Danh sách giá trị lọc kèm số phim. |
Phát video
Phiên phát chỉ được cấp cho trình phát chính thức trên tên miền đã xác minh. Link phát là tạm thời và được làm mới tự động; không lưu hoặc chia sẻ link playlist.
Ví dụ tìm kiếm và phân trang
curl "https://api.phimnganapi.com/v1/search?q=love&page=1&limit=36&content=live_action&audio=vietsub"
# Response: { "page": 1, "limit": 36, "total": 42, "items": [...] }
# Đồng bộ tăng dần: dùng /v1/movies/updated với cursor do API trả về
curl "https://api.phimnganapi.com/v1/movies/updated?cursor=0.0&limit=100"Webmaster UI hiện chỉ cho xem danh mục công khai và tạo mã nhúng mẫu. Quản lý tài khoản, xác minh tên miền và API key cần thực hiện qua quy trình quản trị riêng; không nhập hoặc đặt API key trong HTML.