Tài Liệu API - Danh Sách Video

Hướng dẫn sử dụng API để lấy danh sách video mới nhất và phân trang.

1. Mô Tả API

API này cung cấp danh sách video mới nhất với khả năng phân trang. Dữ liệu trả về bao gồm các thông tin về video như tiêu đề, đường dẫn slug, đường dẫn video, đường dẫn ảnh thumbnail và thời gian tạo video.

Địa chỉ API: /api/phim-moi-nhat

2. Phương Thức HTTP

3. Tham Số Yêu Cầu

Tham số yêu cầu dùng để xác định trang và số lượng video muốn nhận. Dưới đây là các tham số yêu cầu:

Tham số Loại Mô Tả Mặc Định
page integer Trang hiện tại để phân trang, giá trị từ 1 trở lên. 1
limit integer Số lượng video trả về trong mỗi trang. 10

4. Ví Dụ Yêu Cầu

Ví dụ yêu cầu API:

GET /api/phim-moi-nhat?page=1&limit=10

5. Dữ Liệu Trả Về

API trả về dữ liệu dưới định dạng JSON với cấu trúc như sau:


{
  "current_page": 1,
  "total_pages": 5,
  "total_videos": 50,
  "videos": [
    {
      "id": 1,
      "title": "Video 1",
      "slug": "video-1",
      "video_path": "/videos/video-1.mp4",
      "thumb_path": "/images/video-1-thumbnail.jpg",
      "created_at": "2025-02-17T12:34:56"
    },
    ...
  ]
}
            

6. Phân Trang

Để truy vấn các trang khác, bạn có thể thay đổi tham số page trong URL.

7. Mã Trạng Thái Lỗi

Mã lỗi Mô Tả
400 Tham số yêu cầu không hợp lệ.
404 Không tìm thấy tài nguyên.
500 Lỗi máy chủ, vui lòng thử lại sau.